# Timbre

> Timbre is an open-source MCP server for ai models and llm tooling. Let AI assistants search, read and organise Apple Mail on your Mac, with undo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS
- **Website:** https://alejandrosml.github.io/timbre/
- **MCP Registry name:** io.github.alejandrosml/timbre
- **Categories:** AI models and LLM tooling, communication, productivity
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

```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"
      ]
    }
  }
}
```

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

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

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

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

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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [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.

---
Source: https://ai-powered.com/mcp/timbre
