Agent skill · software engineering · agentmail-to
agentmail-toolkit
Add AgentMail tools to agent frameworks with the TypeScript or Python AgentMail Toolkit. Use for Vercel AI SDK, LangChain, OpenAI Agents SDK, LiveKit Agents, or MCP adapters; do not use for direct mailbox operations, raw SDK implementation, CLI usage, or MCP client setup.
Why this skill is useful
Provides a toolkit with specific commands and integrations for various agent frameworks that the AI wouldn't reliably generate on its own.
What it needs
Requires agentmail-toolkit installed locally. Requires agentmail account access. About 3k tokens when loaded. Last updated 2026-07-21. 21 stars on the source repository.
What this skill does
AgentMail Toolkit Install the toolkit for the selected language and set AGENTMAILAPIKEY. 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 Vercel AI SDK LangChain MCP server tools 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 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 Existing client The toolkit constructor takes an existing SDK client as its only argument — it does not accept an apikey option directly. Construct the SDK client first, then pass it in. LangChain LiveKit Agents Subclass the LiveKit Agent and pass instructions and toolkit tools through super().init. Results and errors Requires toolkit TypeScript >= 0.5.0 or Python >= 0.3.0. Every tool declares an output schema. MCP tool calls return validated structuredContent plus a matching JSON text block on success; void operations (deletes) return a stable { success: true } object. A failed tool call is signaled through each framework's native error channel, not as a successful result. The Vercel AI SDK, LangChain, and clawdbot adapters (and the generic export) throw on failure — surfacing a distinct tool-error the model can tell apart from a normal result — and the MCP adapter returns isError: true. Do not treat a returned value as an error string; catch the thrown error or check isError. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills agentmail-to/agentmail-toolkit