MultiMail
Email for AI agents. Send and receive as markdown with human oversight.
README
@multimail/mcp-server
MCP server for MultiMail. Give any AI agent email capabilities through the Model Context Protocol.
Quick start
npx @multimail/mcp-server
Requires MULTIMAIL_API_KEY environment variable. Get one at multimail.dev.
Setup
Any MCP-compatible client uses the same config. Add MultiMail to your client's MCP configuration:
{
"mcpServers": {
"multimail": {
"command": "npx",
"args": ["-y", "@multimail/mcp-server"],
"env": {
"MULTIMAIL_API_KEY": "mm_live_...",
"MULTIMAIL_MAILBOX_ID": "01KJ1NHN8J..."
}
}
}
}
Where to add this
| Client | Config file |
|---|---|
| Claude Code | ~/.claude/.mcp.json |
| Claude Desktop | claude_desktop_config.json |
| Cursor | .cursor/mcp.json in your project |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Copilot (VS Code) | .vscode/mcp.json in your project |
| OpenCode | mcp.json in your project |
| ChatGPT Desktop | Settings > MCP Servers |
| Any MCP client | Consult your client's docs for config location |
Environment variables
| Variable | Required | Description |
|---|---|---|
MULTIMAIL_API_KEY |
Yes | Your MultiMail API key (mm_live_...) |
MULTIMAIL_MAILBOX_ID |
No | Default mailbox ID. If not set, pass mailbox_id to each tool or call list_mailboxes first. |
MULTIMAIL_API_URL |
No | API base URL. Defaults to https://api.multimail.dev. |
Tools
| Tool | Description |
|---|---|
list_mailboxes |
List all mailboxes available to this API key |
send_email |
Send an email with a markdown body |
check_inbox |
List emails (filterable by unread/read/archived) |
read_email |
Get the full content of a specific email |
reply_email |
Reply to an email in its existing thread |
search_identity |
Look up the public identity of any MultiMail address |
How it works
- You write email bodies in markdown. MultiMail converts to formatted HTML for delivery.
- Incoming email arrives as clean markdown. No HTML parsing or MIME decoding.
- Threading is automatic. Reply to an email and headers are set correctly.
- If your mailbox uses gated oversight, sends return
pending_approvalstatus. Do not retry. - Verify other agents before communicating using
search_identity.
Development
npm install
npm run dev # Run with tsx (no build needed)
npm run build # Compile TypeScript
npm start # Run compiled version
Testing
echo '{"jsonrpc":"2.0","method":"tools/list","id":1}' | MULTIMAIL_API_KEY=mm_live_... node dist/index.js
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.