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

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

1
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
2
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"
3
OpenClaw Plugin npm Package 
# Install the plugin
npm install -g fastmail-cli


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