# GhostPaw Email

> GhostPaw Email is an open-source MCP server for communication. Agent email over IMAP and SMTP with a local SQLite cache, threads and full-text search. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://email.ghostpaw.dev
- **Repository:** https://github.com/ghostpawjs/email
- **MCP Registry name:** io.github.GhostPawJS/email
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add email -- npx -y @ghostpaw/email
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "email": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/email"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "email": {
      "command": "npx",
      "args": [
        "-y",
        "@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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/ghostpaw-email
