GhostPaw Email
Agent email over IMAP and SMTP with a local SQLite cache, threads and full-text search
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.5.11
- Listing updated
- 2 days ago
About GhostPaw Email
GhostPaw Email is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.
GhostPaw email separates reading from sending, so a harness can expose only the operations it wants a model to have. Messages are cached in a SQLite file on your disk with conversation threads and FTS5 search; credentials come from the environment. The MIT-licensed project ships as a binary that carries its own Node.js, or as an npm package that needs Node.js 24 or newer, with zero runtime dependencies.
The MCP server starts with ghostpaw-email mcp (or npx -y @ghostpaw/email mcp) and keeps its cache at ~/.ghostpaw/email.db unless GHOSTPAW_EMAIL_DB or --db says otherwise. Discovery and cached reads need no account; network operations use an account added through the CLI or the EMAIL_IMAP_HOST, EMAIL_SMTP_HOST, EMAIL_USER and EMAIL_PASS variables, with EMAIL_ACCESS_TOKEN as an alternative. Each network call opens and closes its own IMAP session.
The README also documents running it inside a Codex CLI sandbox, where the database path must sit in a writable root. Claude Desktop users can install a server.mcpb bundle, and a Dockerfile is included. It speaks several MCP revisions, including the 2026-07-28 stateless one.
Install
Run in a terminal
claude mcp add email -- npx -y @ghostpaw/emailAdd to claude_desktop_config.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/email"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/email"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"email": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ghostpaw/email"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/email"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"email": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/email"
]
}
}
}Configuration
GHOSTPAW_EMAIL_DBSQLite database path (default: ~/.ghostpaw/email.db)
What it does
- Separate read and send tools
- A harness can expose reading without allowing sends.
- Local SQLite cache
- Messages and bodies are stored on disk with threads.
- FTS5 search
- Full-text search across cached mail.
- IMAP and SMTP
- Works with standard mail accounts by environment variables or CLI setup.
- Zero runtime dependencies
- Ships as a single bundle that includes its own Node.js in the binary.
- Many client setups
- Instructions for Claude Code, Cursor, Claude Desktop and Codex.
Good for
- Let an agent search past conversations about an invoice
- Reply to a thread from a coding agent with sending enabled
- Give a read-only agent access to cached mail
- Build a Node.js app that embeds an email engine
Pricing
Open source
Free and MIT licensed
Prices change. Check email.ghostpaw.dev before you buy.
GhostPaw Email FAQ
Can an agent be limited to reading?
Yes. Reading and sending are separate tools, so a harness can expose only what it permits.
Where is mail stored?
In a SQLite file, `~/.ghostpaw/email.db` by default, which you can move with `GHOSTPAW_EMAIL_DB` or `--db`.
Is it free?
The site says it is free and MIT licensed.
What does it need?
Node.js 24 or newer for the npm package; the binary bundles its own Node.js.
Is GhostPaw Email free?
Yes. GhostPaw Email is open source, so you can use and self-host it for free.
How do I add GhostPaw Email to Claude Code?
Run this command in your terminal: claude mcp add email -- npx -y @ghostpaw/email
What are the best alternatives to GhostPaw Email?
The closest alternatives to GhostPaw Email are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to GhostPaw Email

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity