Claude Desktop

After this page, Claude Desktop starts email-mcp, an MCP (Model Context Protocol) server, and can use its tools. The agent is the AI (artificial intelligence) program that uses these tools. A tool is one action that the agent can call, such as search_messages.

Source and date

Source: https://modelcontextprotocol.io/docs/2026-07-28/develop/connect-local-servers, checked on 2026-10-29.

Add email-mcp (stdio)

Claude Desktop starts email-mcp over stdio (standard input and output: the app starts the program and talks to it directly, with no network).

Open Settings → Developer → Edit Config. That opens the config file (the file that holds the settings of the app):

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add email-mcp under mcpServers. Use the absolute path of the binary (the full path of the program file; find it with which email-mcp, or where email-mcp on Windows). The docs say that the paths must be absolute. The file is in JSON (JavaScript Object Notation: a text format for data):

{
  "mcpServers": {
    "email": {
      "command": "/opt/homebrew/bin/email-mcp",
      "args": ["serve"]
    }
  }
}

Restart Claude Desktop after you change the file. The log of the server is in ~/Library/Logs/Claude/ (macOS) or %APPDATA%\Claude\logs (Windows).

If your master key is a file

Use this only when your master key (the key that protects your stored passwords) is a file. By default, the master key is in the keychain (the password store of your operating system), and you need nothing more.

With a key file as the master key, add an env block. It sets the environment variable (a named setting that a program reads from its surroundings) EMAIL_MCP_KEK for the server. KEK means key encryption key. Restart Claude Desktop after you change the file.

{
  "mcpServers": {
    "email": {
      "command": "/opt/homebrew/bin/email-mcp",
      "args": ["serve"],
      "env": {
        "EMAIL_MCP_KEK": "file:/Users/you/.email-mcp.key"
      }
    }
  }
}

Confirmation

[not verified]. The docs do not say whether Claude Desktop supports elicitation (a way for a server to ask the person a question through the app). If it does not, every send that needs a confirmation returns the approval link (a link to a web page where you approve or reject the send).

The page How each AI app confirms compares the five apps.

Next: Your first use