Skip to content
MCP server

Timbre

Let AI assistants search, read and organise Apple Mail on your Mac, with undo

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS
Runs
Locally
Version
0.7.6
Listing updated
2 days ago

About Timbre

Timbre is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

Safety is the design focus. Mail text that a sender hid is stripped before the assistant sees it, each message is marked untrusted, and forged senders are flagged. Sending is off unless you enable it, anything that acts later asks for your click in a window, and every change can be undone.

Search is full text across all accounts set up in Mail, covering message bodies and attachment names, run locally. Beyond reading, it handles drafts, filing, rules and mailboxes. It runs entirely on your Mac with its own permission, with no server, analytics or telemetry.

It works with Claude, ChatGPT, Gemini, Mistral, LM Studio, Raycast AI and Perplexity. Claude Desktop installs the .mcpb file, after which Timbre needs Full Disk Access; for other assistants a zip installer lists the assistants it finds and connects the ones you tick, then updates itself only from releases signed by the same developer and notarized by Apple. Version 0.7.4 was developed on macOS 27 with Apple Silicon and is built for macOS 12 and later, including Intel. The source is MIT licensed.

Install

Run in a terminal

claude mcp add timbre -- npx -y https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "timbre": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "timbre": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "timbre": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "timbre": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "timbre": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb"
      ]
    }
  }
}

What it does

Local full-text search
Searches bodies and attachment names across every account in Mail.
Hidden-text removal
Strips text a sender hid and marks each message as untrusted.
Forged sender flags
Flags senders that look spoofed.
Undoable changes
Every change can be undone.
Sending off by default
Sending must be enabled by you; later actions ask for a click.
No telemetry
Runs on the Mac with no server or analytics.

Good for

  • Find an old email by what the attachment was called
  • Have an assistant draft replies without sending them
  • File or sort mail with rules suggested by the assistant
  • Review mail from several accounts in one chat
  • Undo an assistant's mailbox change

Pricing

Open source

Open source under the MIT licence

Prices change. Check alejandrosml.github.io before you buy.

Timbre FAQ

Does it send my mail to a server?

No. It runs on your Mac and has no server, analytics or telemetry.

Can the assistant send email?

Only if you turn sending on; it is off by default.

Which Macs are supported?

Built for macOS 12 and later on Intel and Apple Silicon, and tested on macOS 27 with Apple Silicon.

What does it need to work?

Full Disk Access for Timbre, granted in macOS settings.

Is Timbre free?

Yes. Timbre is open source, so you can use and self-host it for free.

How do I add Timbre to Claude Code?

Run this command in your terminal: claude mcp add timbre -- npx -y https://github.com/alejandrosml/timbre-download/releases/download/v0.7.6/timbre-0.7.6.mcpb

What are the best alternatives to Timbre?

The closest alternatives to Timbre are Ha MCP, Claude Code Ultimate Guide, Concord MCP, note1 and BoardAgent.

Alternatives to Timbre

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  3. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  4. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  5. BoardAgent

    MCP server

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

    • 27 tools
    • Remote
    • Free
    • Community directories
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media