Mailspring MCP Server

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.

Category
Visit Server

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.

  1. Install dependencies and build the plugin:
npm install
npm run build
  1. Install the built plugin into Mailspring through Mailspring's plugin install flow, or place the built plugin directory in Mailspring's packages directory.

  2. 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.

  1. Install dependencies and build:

    npm install
    npm run build
    
  2. Link the repo into Mailspring's packages directory so Mailspring loads your working copy:

./install.sh
  1. 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

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.

Official
Featured
TypeScript
Magic Component Platform (MCP)

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.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

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.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

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.

Official
Featured
TypeScript
Kagi MCP Server

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.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
Exa Search

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.

Official
Featured