# agentmail-toolkit

Adds AgentMail tools to agent frameworks such as Vercel AI SDK and LangChain. Useful when building TypeScript or Python agents that need email capabilities.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 25
- Author: agentmail-to
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/agentmail-to/agentmail-skills/tree/HEAD/agentmail-toolkit/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/agentmail-toolkit

## What it does

This skill provides instructions for wiring AgentMail tools into agent libraries. It covers integrations with Vercel AI SDK, LangChain, OpenAI Agents SDK, and LiveKit Agents. Direct mailbox tasks belong elsewhere.

Instead of hardcoding function names, it queries the catalog at runtime with `getTools()` or `get_tools()`. Tool selections differ between Python and TypeScript packages and ship on distinct schedules. The MCP server adapter is available solely in TypeScript.

You need an `AGENTMAIL_API_KEY` and minimum versions of TypeScript 0.5.0 or Python 0.3.0. The constructor expects an instantiated SDK client rather than an inline API key object. Raw configuration objects fail immediately. Tool failures throw exceptions in supported frameworks rather than returning error strings.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-toolkit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agentmail-toolkit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agentmail-toolkit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-toolkit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agentmail-toolkit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-toolkit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agentmail-toolkit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install agentmail-to/agentmail-skills agentmail-toolkit
```

2. **Manually: put the files in place**
- File: `.github/skills/agentmail-toolkit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-toolkit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmail-toolkit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agentmail-toolkit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add agentmail-to/agentmail-skills --skill agentmail-toolkit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/agentmail-to/agentmail-skills/tree/HEAD/agentmail-toolkit/SKILL.md

## When to use it
- connect AgentMail tools to Vercel AI SDK or LangChain
- give Python OpenAI Agents SDK access to email actions
- expose email tool definitions on a custom TypeScript MCP server
- equip LiveKit Agents with inbound message handling

## Example prompts
- Wire AgentMail tools into my TypeScript LangChain agent
- Configure the AgentMail toolkit for OpenAI Agents SDK in Python
- Set up AgentMail tools on my custom MCP server

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [agentmail-to/agentmail-skills](https://affpapa.org/en/nevibecode/by/agentmail-to/agentmail-skills.md) — 6 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md