1
Add it to Claude Code
claude mcp add -e "FASTMAIL_API_TOKEN=${FASTMAIL_API_TOKEN}" fastmail-mcp-server -- npx -y @alexdiazdecerio/fastmail-mcp-serverRequired:
FASTMAIL_API_TOKEN2
Make your agent remember this setup
fastmail-mcp-server's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Secure token-based authentication
- JMAP API integration for email management
- Access to email usage analytics and reports
- Granular permission control
- Audit logging for all API interactions
Tools 2
manage_emailsPerform operations on emails within the Fastmail accountget_usage_analyticsRetrieve email usage insights and reportsEnvironment Variables
FASTMAIL_API_TOKENrequiredSecure token for JMAP API authenticationTry it
→List the most recent emails in my inbox.
→Summarize the email usage analytics for the last month.
→Find emails from a specific sender and move them to the archive folder.
→Check my current email storage usage statistics.
Original README from alexdiazdecerio/fastmail-mcp-server
🧪 Development
Available Scripts
npm run build # Compile TypeScript
npm run watch # Watch mode for development
npm run dev # Build and run server
npm run inspector # Debug with MCP inspector
Testing
npm test # Run test suite
npm run lint # Code quality checks
npm audit # Security vulnerability scan
🛡️ Security
- Token-based Authentication - No password storage
- Granular Permissions - Minimum required access scope
- Environment Variables - Secure credential management
- Audit Logging - Track all API interactions
🤝 Contributing
We welcome contributions! Please see our Contributing Guide for details.
Development Workflow
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
📈 Roadmap
- Email Templates - Reusable email templates
- Advanced Analytics - Email usage insights and reports ✅ COMPLETED v1.1.0
- Multi-Account Support - Manage multiple Fastmail accounts
- Webhook Support - Real-time email notifications
- Plugin System - Extensible architecture for custom features
- Threading Reliability - Fix intermittent reply functionality issues
📞 Support
- Documentation - Comprehensive guides and API reference
- Issues - Report bugs or request features on GitHub
- Discussions - Community support and feature discussions
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🙏 Acknowledgments
- Fastmail - For their excellent JMAP API
- Anthropic - For the MCP protocol and Claude integration
- Community - For feedback, contributions, and support
⭐ If this project helped you, please give it a star on GitHub! ⭐
⚡ Get Started • 📚 Documentation • 🐛 Report Bug • 💡 Request Feature