fastmail-mcp
An MCP server for Fastmail that provides access to email, contacts, and calendars via the JMAP protocol. It enables users to search, send, and bulk-manage emails while also interacting with calendar events and address books through natural language.
README
fastmail-mcp
An MCP (Model Context Protocol) server for Fastmail that provides access to email, contacts, and calendars via the JMAP protocol.
Tools
| Tool | Description |
|---|---|
list_mailboxes |
List all mailboxes in the account |
list_emails |
List emails from a mailbox |
get_email |
Get a specific email by ID |
get_recent_emails |
Get the most recent emails from inbox |
search_emails |
Search emails by subject or content |
advanced_search |
Advanced email search with multiple criteria (sender, recipient, date range, attachments, etc.) |
send_email |
Send an email |
reply_email |
Reply to an email with proper threading headers |
save_draft |
Save an email as a draft with optional threading support |
create_draft |
Create an email draft without sending |
mark_email_read |
Mark an email as read or unread |
delete_email |
Delete an email (move to trash) |
move_email |
Move an email to a different mailbox |
add_labels |
Add labels (mailboxes) to an email |
remove_labels |
Remove labels (mailboxes) from an email |
get_email_attachments |
List attachments for an email |
download_attachment |
Download an email attachment (save to disk or get URL) |
get_thread |
Get all emails in a conversation thread |
get_mailbox_stats |
Get mailbox statistics (unread count, total, etc.) |
get_account_summary |
Get overall account summary with statistics |
Bulk Operations
| Tool | Description |
|---|---|
bulk_mark_read |
Mark multiple emails as read/unread |
bulk_move |
Move multiple emails to a mailbox |
bulk_delete |
Delete multiple emails (move to trash) |
bulk_add_labels |
Add labels to multiple emails |
bulk_remove_labels |
Remove labels from multiple emails |
Contacts
| Tool | Description |
|---|---|
list_contacts |
List contacts from the address book |
get_contact |
Get a specific contact by ID |
search_contacts |
Search contacts by name or email |
Calendars
| Tool | Description |
|---|---|
list_calendars |
List all calendars |
list_calendar_events |
List events from a calendar |
get_calendar_event |
Get a specific calendar event by ID |
create_calendar_event |
Create a new calendar event |
Utility
| Tool | Description |
|---|---|
list_identities |
List sending identities (email addresses) |
check_function_availability |
Check which functions are available based on account permissions |
test_bulk_operations |
Test bulk operations with a dry-run mode |
Environment Variables
| Variable | Required | Description |
|---|---|---|
FASTMAIL_API_TOKEN |
Yes | Fastmail API token (create one here) |
Setup
npm ci
Usage
Stdio mode (for Claude Desktop, Claude Code, etc.)
node dist/index.js
HTTP mode (with mcp-proxy)
npx mcp-proxy --port 8003 -- node dist/index.js
Claude Desktop configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"fastmail": {
"command": "node",
"args": ["/path/to/fastmail-mcp/dist/index.js"],
"env": {
"FASTMAIL_API_TOKEN": "your-api-token"
}
}
}
}
License
MIT
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.