MCP Overview

The Model Context Protocol (MCP) enables AI assistants like Claude to directly access and interact with your MoMail data through a standardized interface.

What is MCP?

MCP (Model Context Protocol) is an open standard for connecting AI assistants to data sources. With MoMail’s MCP server, Claude can:

• Search your emails using natural language
• Retrieve specific emails and conversation threads
• Download original MIME (.eml) as base64
• List your mailboxes and their contents
• Access email metadata and attachments

Architecture

MoMail implements the MCP protocol using StreamableHTTP transport:

┌─────────────┐      StreamableHTTP       ┌─────────────┐
│   Claude    │  <───────────────────>   │ MoMail MCP  │
│   Desktop   │      (HTTP POST)         │   Server    │
└─────────────┘                           └─────────────┘
                                                 │
                                                 ▼
                                          ┌─────────────┐
                                          │  MoMail     │
                                          │  Database   │
                                          └─────────────┘

Key Features

Natural Language Search

Ask Claude to find emails using plain English queries

Thread Context

Claude can access entire conversation threads for better context

Secure Access

API key authentication with rate limiting

No Data Storage

Claude does not store your email data between sessions

MCP endpoint

https://momail.io/v1/mcp

Transport: StreamableHTTP (POST for JSON-RPC, session headers per MCP spec). Authenticate with Authorization: Bearer mk_… on every request.

Available Tools

MoMail exposes five MCP tools:

Tool	Purpose
search_emails	Find emails using natural language or filters
get_email	Retrieve a specific email by ID
get_email_thread	Get all emails in a conversation thread
get_email_raw	Original MIME as base64 (same bytes as REST raw download)
list_mailboxes	View all your mailboxes and their status

Getting Started

To use MoMail with Claude Desktop:

1. Configure Claude Desktop with your API key
2. Learn about available tools
3. See example conversations

Rate Limits

MCP requests are subject to rate limits based on your plan:

Plan	Requests per Minute
Free	10
Pro	60
Enterprise	300

Security Considerations

• Your API key is stored locally in Claude Desktop configuration
• All MCP requests use HTTPS encryption
• MoMail validates API keys on every request
• Session data is not persisted between Claude sessions

Next Steps

Configure Claude Desktop Step-by-step setup guide

Tool Reference Complete tool documentation

Example Conversations See MCP in action