Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@pyfastmail-mcpSummarize my recent unread emails"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pyfastmail-mcp
An MCP server that gives AI assistants full access to your Fastmail account — email, contacts, calendars, and file storage.
⚠️ This server can send email, delete messages, and modify contacts/calendars on your behalf. AI assistants may act on content from untrusted sources (emails, web pages, files) which could contain prompt injection attacks. Review tool calls before approving them, especially actions that send email or delete data.
Features
42 tools across 4 protocols:
Domain | Protocol | Tools |
JMAP | Send, reply, forward, search, read, archive, labels, masked email, attachments, threads | |
Contacts | CardDAV | List address books, CRUD contacts |
Calendar | CalDAV | List calendars, CRUD events |
Files | WebDAV | List, upload, download, move, delete, create folders |
Installation
pip install pyfastmail-mcpOr run directly with uvx:
uvx pyfastmail-mcpConfiguration
1. Get Fastmail Credentials
You need two credentials from Fastmail:
API Token (for JMAP/mail): Fastmail Settings → Privacy & Security → API Tokens
App Password (for CardDAV/CalDAV/WebDAV): Fastmail Settings → Privacy & Security → App Passwords — create one with DAV access
2. Set Environment Variables
export FASTMAIL_API_TOKEN="fmu1-..."
export FASTMAIL_APP_PASSWORD="your-app-password"
export FASTMAIL_EMAIL="you@fastmail.com"3. Add to Your MCP Client
For Claude Desktop, add to claude_desktop_config.json:
{
"mcpServers": {
"fastmail": {
"command": "uvx",
"args": ["pyfastmail-mcp"],
"env": {
"FASTMAIL_API_TOKEN": "fmu1-...",
"FASTMAIL_APP_PASSWORD": "your-app-password",
"FASTMAIL_EMAIL": "you@fastmail.com"
}
}
}
}For Kiro CLI, add to .kiro/settings/mcp.json:
{
"mcpServers": {
"fastmail": {
"command": "uvx",
"args": ["pyfastmail-mcp"],
"env": {
"FASTMAIL_API_TOKEN": "${FASTMAIL_API_TOKEN}",
"FASTMAIL_EMAIL": "${FASTMAIL_EMAIL}",
"FASTMAIL_APP_PASSWORD": "${FASTMAIL_APP_PASSWORD}"
}
}
}
}Tools
Mail (mail_*)
Tool | Description |
| Verify connection and auth |
| List all mailboxes |
| Create a mailbox |
| Rename a mailbox |
| Delete a mailbox |
| Get a single email by ID |
| Get recent emails |
| Search by query |
| Get full thread |
| Mark read/unread |
| Move to mailbox |
| Move to trash |
| Archive |
| Add/remove labels |
| List send-as identities |
| Send new email |
| Reply to email |
| Forward email |
| List masked emails |
| Create masked email |
| Enable/disable masked email |
| Download attachment |
| Upload blob for sending |
Contacts (contacts_*)
Tool | Description |
| List address books |
| List contacts |
| Get contact details |
| Create contact |
| Update contact |
| Delete contact |
Calendar (calendar_*)
Tool | Description |
| List calendars |
| List events |
| Get event details |
| Create event |
| Update event |
| Delete event |
Files (files_*)
Tool | Description |
| List files/folders |
| Download file |
| Upload file |
| Create folder |
| Move/rename file |
| Delete file/folder |
Development
git clone https://github.com/pjosols/pyfastmail-mcp.git
cd pyfastmail-mcp
uv sync --group dev
uv run pytestLicense
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.