AgentMail Toolkit Skill

AgentMail Toolkit

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

Installation

# TypeScript/Node
npm install agentmail-toolkit

# Python
pip install agentmail-toolkit

Configuration

Set your API key as an environment variable:

export AGENTMAIL_API_KEY=your-api-key

Get your API key from console.agentmail.to.

TypeScript Frameworks

Vercel AI SDK

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

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.

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

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

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.

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
const toolkit = new AgentMailToolkit({ apiKey: "your-api-key" });

# Python
toolkit = AgentMailToolkit(api_key="your-api-key")

Custom Client

# 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 |

Agent Skills: AgentMail Toolkit

Install this agent skill to your local

Skill Files