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

The Node and Python toolkits ship different tool sets. The Node toolkit includes drafts;

the Python toolkit does not.

Node toolkit: 17 tools. Python toolkit: 11 tools. If you need draft support from Python,

call client.inboxes.drafts.* directly on the AgentMail SDK client.

Custom Configuration

Both toolkits take an existing SDK client as their only constructor argument — they do NOT

accept apiKey / api_key directly. If you need a custom API key, construct the SDK

client with the key first, then pass the client to the toolkit.

TypeScript

import { AgentMailClient } from "agentmail";

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

// With a custom API key

const client = new AgentMailClient({ apiKey: "your-api-key" });

const toolkit = new AgentMailToolkit(client);

// Or omit the argument to auto-read AGENTMAIL_API_KEY from env

const defaultToolkit = new AgentMailToolkit();

Python

from agentmail import AgentMail

from agentmail_toolkit.openai import AgentMailToolkit

# With a custom API key

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

toolkit = AgentMailToolkit(client=client)

# Or omit the argument to auto-read AGENTMAIL_API_KEY from env

default_toolkit = AgentMailToolkit()

Framework Summary