README.md
Enables AI models to interact with Fastmail accounts via the JMAP API
🧪 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
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 authenticationConfiguration
claude_desktop_config.json
{"mcpServers": {"fastmail": {"command": "npx", "args": ["-y", "@alexdiazdecerio/fastmail-mcp-server"], "env": {"FASTMAIL_API_TOKEN": "your_token_here"}}}}Try 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.