[GH-ISSUE #636] Add MCP (Model Context Protocol) server for AI assistant integration #397

Closed
opened 2026-03-15 14:14:45 +03:00 by kerem · 3 comments
Owner

Originally created by @amirhmoradi on GitHub (Feb 4, 2026).
Original GitHub issue: https://github.com/axllent/mailpit/issues/636

Feature Request

Description

Add a Model Context Protocol (MCP) server to Mailpit that enables AI assistants like Claude, Cursor, and VS Code with Copilot to interact with the email testing environment programmatically.

Use Cases

  1. Automated Email Analysis - AI can fetch and analyze emails for issues, spam triggers, and compatibility problems
  2. Search & Navigation - Natural language queries to find emails (e.g., "find all emails from john last week")
  3. Quality Checks - Automated HTML compatibility, link validation, and spam scoring
  4. Test Automation - AI-driven email testing workflows and debugging
  5. Template Development - AI assistance in composing and validating email templates

Proposed Features

  • MCP tools for all Mailpit API endpoints
  • Pre-built prompts for common email workflows
  • Resources for quick inbox state access
  • Support for both STDIO and HTTP transports
  • Docker image for easy deployment

Benefits

  • Enhances Mailpit's value for AI-augmented development workflows
  • Enables natural language interaction with email testing
  • Integrates with popular AI-powered IDEs and assistants

Technical Approach

  • Standalone Go binary using the official MCP SDK
  • Nested in mcp/ directory within the main repository
  • Separate Docker image for flexible deployment
Originally created by @amirhmoradi on GitHub (Feb 4, 2026). Original GitHub issue: https://github.com/axllent/mailpit/issues/636 ## Feature Request ### Description Add a Model Context Protocol (MCP) server to Mailpit that enables AI assistants like Claude, Cursor, and VS Code with Copilot to interact with the email testing environment programmatically. ### Use Cases 1. **Automated Email Analysis** - AI can fetch and analyze emails for issues, spam triggers, and compatibility problems 2. **Search & Navigation** - Natural language queries to find emails (e.g., "find all emails from john last week") 3. **Quality Checks** - Automated HTML compatibility, link validation, and spam scoring 4. **Test Automation** - AI-driven email testing workflows and debugging 5. **Template Development** - AI assistance in composing and validating email templates ### Proposed Features - MCP tools for all Mailpit API endpoints - Pre-built prompts for common email workflows - Resources for quick inbox state access - Support for both STDIO and HTTP transports - Docker image for easy deployment ### Benefits - Enhances Mailpit's value for AI-augmented development workflows - Enables natural language interaction with email testing - Integrates with popular AI-powered IDEs and assistants ### Technical Approach - Standalone Go binary using the official MCP SDK - Nested in `mcp/` directory within the main repository - Separate Docker image for flexible deployment
kerem closed this issue 2026-03-15 14:14:50 +03:00
Author
Owner

@axllent commented on GitHub (Feb 5, 2026):

Thank you. Whilst I appreciate the effort both you and Claude went through to vibe code this, I won't accept this into Mailpit. My reasons are simple: I do not want to support and maintain an entirely separate project (with a somewhat duplicated code-base) which I have no use for.

Please feel free to publish and maintain this "mailpit-mcp" project as your own project however, as I'm sure you and others may find it a useful bridge with AI in your testing.

<!-- gh-comment-id:3850882743 --> @axllent commented on GitHub (Feb 5, 2026): Thank you. Whilst I appreciate the effort both you and Claude went through to vibe code this, I won't accept this into Mailpit. My reasons are simple: I do not want to support and maintain an entirely separate project (with a somewhat duplicated code-base) which I have no use for. Please feel free to publish and maintain this "mailpit-mcp" project as your own project however, as I'm sure you and others may find it a useful bridge with AI in your testing.
Author
Owner

@amirhmoradi commented on GitHub (Feb 5, 2026):

Thanks for your prompt response. I have created my own project "mailpit-mcp" that we use in our dev team now, available here: https://github.com/amirhmoradi/mailpit-mcp

<!-- gh-comment-id:3854316568 --> @amirhmoradi commented on GitHub (Feb 5, 2026): Thanks for your prompt response. I have created my own project "mailpit-mcp" that we use in our dev team now, available here: [https://github.com/amirhmoradi/mailpit-mcp]( https://github.com/amirhmoradi/mailpit-mcp)
Author
Owner

@mohammedmogib397 commented on GitHub (Feb 18, 2026):

https://github.com/amirhmoradi/mailpit-mcp

<!-- gh-comment-id:3917734847 --> @mohammedmogib397 commented on GitHub (Feb 18, 2026): https://github.com/amirhmoradi/mailpit-mcp
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/mailpit#397
No description provided.