agentmail-toolkit

Files (1)

• SKILL.md

SKILL.md (first lines)

# AgentMail Toolkit

Install the toolkit for the selected language and set `AGENTMAIL_API_KEY`.

```bash
npm install agentmail-toolkit
pip install agentmail-toolkit
```

The TypeScript and Python packages can expose different tool sets and can release on
different schedules. Discover the installed package's tool catalog at runtime instead
of trusting a hardcoded list:

```typescript
new AgentMailToolkit().getTools().map((tool) => tool.name)
```

```python
[tool.name for tool in AgentMailToolkit().get_tools()]
```

## TypeScript

### Vercel AI SDK

```typescript
import { openai } from "@ai-sdk/openai";
import { streamText } from "ai";
import { AgentMailToolkit } from "agentmail-toolkit/ai-sdk";

const toolkit = new AgentMailToolkit();
const result = await streamText({
  model: openai(process.env.OPENAI_MODEL!),
  messages,
  system: "Use email tools only when the user authorizes the external action.",
  tools: toolkit.getTools(),
});
```

### LangChain

```typescript
import { createAgent } from "langchain";
import { AgentMailToolkit } from "agentmail-toolkit/langchain";

const agent = createAgent({
  model: process.env.LANGCHAIN_MODEL!,
  tools: new AgentMailToolkit().getTools(),
  systemPrompt: "Use email tools only when the user authorizes the external action.",
});
```

### MCP server tools

```typescript
import { AgentMailToolkit } from "agentmail-toolkit/mcp";

const tools = new AgentMailToolkit().getTools();
```

Each tool provides a name, title, description, input schema, output schema, callback, and complete annotations for registration on your own MCP server. On a successful call the MCP adapter returns `structuredContent` (validated against the output schema) alongside the JSON text block; on failure it returns an `isError` result. The Python package does not ship an MCP adapter.

### Existing client

```typescript
import { AgentMailClient } from "agentmail";
import { AgentMailToolkit } from "agentmail-toolkit/ai-sdk";

const client = new AgentMailClient({ apiKey: process.env.AGENTMAIL_API_KEY });
const toolkit = new AgentMailToolkit(client);
```

The toolkit constructor takes an existing SDK client as its only argument — it does not accept an `{ apiKey }` options object directly. Construct the SDK client first, then pass it in.

## Python

### OpenAI Agents SDK

```python
from agentmail_toolkit.openai import AgentMailToolkit
from agents import Agent

agent = Agent(
    name="Email Agent",
    instructions="Use email tools only when the user authorizes the external action.",
    tools=AgentMailToolkit().get_tools(),
)
```

### Existing client

```python
from agentmail import AgentMail
from agentmail_toolkit.openai import AgentMailToolkit

client = AgentMail()
toolkit = AgentMailToolkit(client=client)
```

The toolkit constructor takes an existing SDK client as its only argument — it does not accept an `api_key` option directly. Construct the SDK client first, then pass it in.

### LangChain

```python
import os

from agentmail_toolkit.langchain import AgentMailToolkit
from langchain.agents import create_agent

agent = create_agent(
    model=os.environ["LANGCHAIN_MODEL"],
    tools=AgentMailToolkit().get_tools(),
    system_prompt="Use email tools only when the user authorizes the external action.",
)
```

### LiveKit Agents

```python

From itzmetanjim/coolton, AGPL-3.0.

More from itzmetanjim/coolton