Agent skill

agentmail-toolkit

Add email capabilities to AI agents using popular frameworks. Provides pre-built tools for TypeScript and Python frameworks including Vercel AI SDK, LangChain, Clawdbot, OpenAI Agents SDK, and LiveKit Agents. Use when integrating AgentMail with agent frameworks that need email send/receive tools.

Stars 6
Forks 2

Install this agent skill to your Project

npx add-skill https://github.com/agentmail-to/agentmail-skills/tree/main/agentmail-toolkit

SKILL.md

AgentMail Toolkit

Pre-built email tools for popular agent frameworks. Instantly add inbox management, sending, receiving, and email automation to your agents.

Installation

bash
# TypeScript/Node
npm install agentmail-toolkit

# Python
pip install agentmail-toolkit

Configuration

Set your API key as an environment variable:

bash
export AGENTMAIL_API_KEY=your-api-key

Get your API key from console.agentmail.to.


TypeScript Frameworks

Vercel AI SDK

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

const toolkit = new AgentMailToolkit();

const result = await streamText({
  model: openai("gpt-4o"),
  messages,
  system: "You are an email agent that can send and receive emails.",
  tools: toolkit.getTools(),
});

LangChain

typescript
import { createAgent, HumanMessage, AIMessage } from "langchain";
import { AgentMailToolkit } from "agentmail-toolkit/langchain";

const agent = createAgent({
  model: "openai:gpt-4o",
  tools: new AgentMailToolkit().getTools(),
  systemPrompt: "You are an email agent that can send and receive emails.",
});

const result = await agent.stream({ messages }, { streamMode: "messages" });

Clawdbot (Pi Agent)

For Clawdbot/Pi Agent integration.

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

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

// Each tool has: name, label, description, parameters, execute
for (const tool of tools) {
  agent.registerTool(tool);
}

Python Frameworks

OpenAI Agents SDK

python
from agentmail_toolkit.openai import AgentMailToolkit
from agents import Agent

agent = Agent(
    name="Email Agent",
    instructions="You can send, receive, and manage emails.",
    tools=AgentMailToolkit().get_tools(),
)

LangChain

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

agent = create_agent(
    model="gpt-4o",
    system_prompt="You are an email agent that can send and receive emails.",
    tools=AgentMailToolkit().get_tools(),
)

result = agent.stream({"messages": messages}, stream_mode="messages")

LiveKit Agents

For voice AI agents with email capabilities.

python
from livekit.agents import Agent
from agentmail_toolkit.livekit import AgentMailToolkit

agent = Agent(
    name="Voice Email Agent",
    tools=AgentMailToolkit().get_tools(),
)

Available Tools

All frameworks get access to these tools:

Tool Description
create_inbox Create a new email inbox
list_inboxes List all inboxes
get_inbox Get inbox details
delete_inbox Delete an inbox
send_message Send an email
reply_to_message Reply to an email
list_threads List email threads
get_thread Get thread details
get_attachment Download an attachment
update_message Update message labels

Custom Configuration

Custom API Key

typescript
// TypeScript
const toolkit = new AgentMailToolkit({ apiKey: "your-api-key" });
python
# Python
toolkit = AgentMailToolkit(api_key="your-api-key")

Custom Client

python
# Python - use existing AgentMail client
from agentmail import AgentMail
from agentmail_toolkit.openai import AgentMailToolkit

client = AgentMail(api_key="your-api-key")
toolkit = AgentMailToolkit(client=client)

Framework Summary

Framework TypeScript Import Python Import
Vercel AI SDK from 'agentmail-toolkit/ai-sdk' -
LangChain from 'agentmail-toolkit/langchain' from agentmail_toolkit.langchain import AgentMailToolkit
Clawdbot from 'agentmail-toolkit/clawdbot' -
OpenAI Agents SDK - from agentmail_toolkit.openai import AgentMailToolkit
LiveKit Agents - from agentmail_toolkit.livekit import AgentMailToolkit

Expand your agent's capabilities with these related and highly-rated skills.

agentmail-to/agentmail-skills

agentmail-mcp

AgentMail MCP server for email tools in AI assistants. Use when setting up AgentMail with Claude Desktop, Cursor, VS Code, Windsurf, or other MCP-compatible clients. Provides tools for inbox management, sending/receiving emails, and thread handling.

6 2
Explore
agentmail-to/agentmail-skills

agentmail-cli

Send and receive emails programmatically using the AgentMail CLI. Use when agents need to manage inboxes, send/receive emails, handle threads, drafts, webhooks, and domains via command line.

6 2
Explore
agentmail-to/agentmail-skills

agentmail

Give AI agents their own email inboxes using the AgentMail API. Use when building email agents, sending/receiving emails programmatically, managing inboxes, handling attachments, organizing with labels, creating drafts for human approval, or setting up real-time notifications via webhooks/websockets. Supports multi-tenant isolation with pods.

6 2
Explore
mattpocock/skills

handoff

Compact the current conversation into a handoff document for another agent to pick up.

111,310 9,758
Explore
mattpocock/skills

setup-pre-commit

Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.

111,310 9,758
Explore
mattpocock/skills

obsidian-vault

Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.

111,310 9,758
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results