Mailspring MCP Server
Enables AI agents to read email data (threads, messages, contacts, folders, labels) via the Model Context Protocol using Mailspring's DatabaseStore API.
README
Mailspring MCP Server Plugin
A Mailspring plugin that runs an MCP (Model Context Protocol) server, giving AI agents read-only access to your email data — threads, messages, contacts, folders, and labels.
The plugin uses Mailspring's own DatabaseStore API, making setup easy and seamless.
Installation
Use this if you want to install the plugin into Mailspring and run it normally.
- Install dependencies and build the plugin:
npm install
npm run build
-
Install the built plugin into Mailspring through Mailspring's plugin install flow, or place the built plugin directory in Mailspring's
packagesdirectory. -
Restart Mailspring. The MCP server starts automatically on
http://127.0.0.1:2525/mcp.
MCP Configuration
Import the configuration using the following JSON snippet, example vscode snippet included in repo:
{
"mcpServers": {
"mailspring": {
"url": "http://127.0.0.1:2525/mcp"
}
}
}
Development
Use this if you are actively working on the plugin code.
-
Install dependencies and build:
npm install npm run build -
Link the repo into Mailspring's
packagesdirectory so Mailspring loads your working copy:
./install.sh
- Restart Mailspring.
Available Tools
| Tool | Description |
|---|---|
search_emails |
Full-text search with structured filters (from, to, subject, date range, folder, label, unread, starred, attachments). Supports FTS5 syntax: OR, NOT, quoted phrases, prefix matching. |
read_email |
Read a specific email with full plain-text body content and attachment list |
batch_read_emails |
Read multiple emails at once by ID — full body + attachments for each |
list_threads |
List threads with filters (folder, label, unread, starred, date range, attachments). Returns enriched metadata: message count, last sender, reply status. |
read_thread |
Read a full thread with all messages, reply status, attachment details, sanitized bodyHtml, and stripped plain-text body |
list_contacts |
List or search contacts by name/email |
list_folders |
List all mailbox folders |
list_labels |
List all email labels |
get_recent_emails |
Get recent emails with date range filtering and pagination |
list_drafts |
List draft emails with pagination |
email_stats |
Get mailbox statistics |
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
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
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.