MIT License Free & Open Source 36 MCP Tools

Your Email,
Your Server

A remote MCP server and token-efficient CLI for Fastmail. Email, contacts, and calendar — powered by Cloudflare Workers.

Get Started View on GitHub

fastmail-mcp — zsh — 120×48

❯ claude "Check my inbox for anything urgent"

Using fastmail search_emails tool...

Inbox — 3 unread

  ★ Alice Park  Q2 Budget Final Approval Needed  10:42 AM
  ● GitHub  [fastmail-mcp] New issue #47   9:15 AM
  ● David Chen  Flight itinerary for Tokyo trip   8:30 AM

❯ claude "Reply to Alice — approved, cc finance team"

Using fastmail reply_to_email tool...
✓ Reply sent to alice.park@company.com
  CC: finance-team@company.com
  Re: Q2 Budget Final Approval Needed

❯ claude "Move the GitHub notification to my Dev folder"

Using fastmail move_email tool...
✓ Moved to Dev/GitHub

❯ claude "Find David's phone number"

Using fastmail search_contacts tool...

  David Chen
  Email:  david.chen@company.com
  Phone:  (415) 555-0198

❯ ▌

Everything You Need

A complete MCP toolkit for Fastmail with 36 tools across email, contacts, calendar, and memos.

🛠️

36 MCP Tools

Full coverage of email, contacts, calendar, and memo operations. Read, write, search, organize, and bulk process.

🔌

3 Client Options

Use with Claude Code MCP, the token-efficient CLI, or the OpenClaw plugin — pick what fits your workflow.

🔒

Secure OAuth

Cloudflare Access OAuth with Zero Trust. GitHub or OTP login, per-user allowlists, and encrypted tokens.

⚡

Token Efficient

CLI saves 5-7x tokens vs raw MCP. Compact text output designed for LLM consumption.

☁️

Zero Maintenance

Runs on Cloudflare Workers — no servers to manage, automatic scaling, global edge deployment.

📝

Private Memos

Attach private notes to any email. Yellow inline annotations visible only to you, searchable via has:memo.

How It Works

Three components, one seamless pipeline

💻

MCP Client

Claude Code, CLI, or OpenClaw

→ ↓

⚡

Cloudflare Worker

OAuth, routing, permissions

→ ↓

📧

Fastmail JMAP

Email, contacts, calendar

Deployed globally on Cloudflare's edge network — sub-50ms latency worldwide

36 Tools, 7 Categories

Every email operation you need, from inbox to bulk actions

Email Read 14 Email Write 3 Email Organize 5 Bulk Ops 4 Contacts 3 Calendar 4 Memos 3

Email Read

get_recent_emails get_email list_emails search_emails advanced_search get_email_attachments download_attachment get_thread get_inbox_updates get_mailbox_stats get_account_summary list_mailboxes list_identities check_function_availability

Email Write

send_email create_draft reply_to_email

Email Organize

move_email delete_email mark_email_read flag_email generate_email_action_urls

Bulk Ops

bulk_move bulk_delete bulk_mark_read bulk_flag

Contacts

search_contacts get_contact list_contacts

Calendar

list_calendars list_calendar_events get_calendar_event create_calendar_event

Memos

create_memo get_memo delete_memo

Quick Start

Three ways to get started — pick your preferred setup

Claude Code Recommended

# Add the MCP server
claude mcp add --transport http fastmail \
  "https://your-worker.example.com/mcp"


# Authenticate when prompted via /mcp
# Then use Fastmail tools directly in Claude Code

CLI Token Efficient

# Install and authenticate
alias fastmail="npx tsx cli/main.ts"
fastmail auth --url 
https://your-worker.example.com


# Check your inbox
fastmail inbox
fastmail email search "from:team@example.com"

OpenClaw Plugin npm Package

# Install the plugin
npm install -g fastmail-cli


# Configure in OpenClaw workspace
# The CLI handles auth automatically
fastmail auth status

Your Email, Your Server