Skip to content
MCP server

GhostPaw Email

Agent email over IMAP and SMTP with a local SQLite cache, threads and full-text search

Runs locallyStatus and history
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/email

Add to claude_desktop_config.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity