๐ง Mailcow MCP Server
Model Context Protocol (MCP) server for complete Mailcow email server management
A comprehensive TypeScript implementation that provides AI models with full control over Mailcow email servers through the Model Context Protocol. Manage domains, mailboxes, queues, sync jobs, and send emails - all with a single, secure API.
โจ Features
๐ฏ Complete Email Management - 20 MCP tools for full Mailcow control
๐ Enterprise Security - API key authentication with granular permissions
โก High Performance - Built with TypeScript for speed and reliability
๐ Comprehensive Logging - Full audit trail and monitoring capabilities
๐งช Well Tested - Extensive test suite with >85% coverage on core modules
๐ Production Ready - Used in production environments
๐ Quick Start
๐ That's it! Your MCP server is now running with 20 tools ready for AI integration.
๐ Detailed setup: Quick Start Guide
๐ ๏ธ Available Tools
Email Management (18 tools)
Domains (5): List, create, update, delete, get details
Mailboxes (5): List, create, update, delete, get details
Email Sending (3): Send emails, check delivery status, get templates
Queue Management (6): List, flush, delete, hold, release queue items
Sync Jobs (7): Manage email migration and synchronization
Log Analysis (4): System, error, performance, and access logs
System Tools (3 tools)
Health Check: Server status and metrics
Configuration: Current settings (sanitized)
API Test: Validate Mailcow connectivity
๐ Current Status
๐ข MVP Complete - Full email server management capability
๐ข Production Ready - Deployed and tested in live environments
๐ข Well Documented - Comprehensive guides and API reference
Component | Status | Coverage | Tools |
Domain Management | โ Complete | 85% | 5 tools |
Mailbox Management | โ Complete | 87% | 5 tools |
Email System | โ Complete | MVP | 3 tools |
Queue Management | โ Complete | New | 6 tools |
Sync Jobs | โ Complete | New | 7 tools |
Log Management | โ Complete | New | 4 tools |
System Tools | โ Complete | 100% | 3 tools |
๐๏ธ Architecture
๐ Documentation
Document | Purpose |
Get running in 5 minutes | |
System design and components | |
Complete tool documentation | |
Environment setup guide | |
Testing framework and practices |
Developer Resources
CLAUDE.md - Essential context for Claude Code sessions
Team Structure - Parallel development workflow
๐ง Development
๐ Example Usage
Send an Email
Manage Domains
Monitor System
๐ Security
API Key Authentication with Mailcow integration
Granular Permissions system (read/write/delete by resource)
Input Validation with JSON Schema enforcement
Audit Logging for all operations
HTTPS Enforcement and SSL certificate validation
Rate Limiting to prevent abuse
๐ค Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-feature
Add tests for your changes
Ensure all tests pass:
npm run test:all
Commit your changes:
git commit -m 'Add amazing feature'
Push to the branch:
git push origin feature/amazing-feature
Open a Pull Request
See CONTRIBUTING.md for detailed guidelines.
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
๐ Support
Documentation: docs/README.md
Issues: GitHub Issues
Discussions: GitHub Discussions
๐ Acknowledgments
Model Context Protocol - The protocol that makes this possible
Mailcow - The excellent email server platform
TypeScript - For robust type safety and excellent tooling
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Enables complete management of Mailcow email servers through 20 MCP tools including domain management, mailbox operations, email sending, queue management, sync jobs, and system monitoring. Provides AI models with full control over email server infrastructure through secure API integration.
Related MCP Servers
- AsecurityAlicenseAqualityProvides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.Last updated -26MIT License
- -securityAlicense-qualityMCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.Last updated -60GPL 3.0
- AsecurityFlicenseAqualityAn MCP-based email tool that enables AI models to access email services through standardized interfaces, allowing AI assistants to perform various email operations like sending emails, reading inboxes, and handling attachments.Last updated -1738
- -securityAlicense-qualityAn MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.Last updated -MIT License