@alexdiazdecerio/fastmail-mcp-server/README.md

🚀 Professional MCP Server for Fastmail email management using JMAP API - Integrates seamlessly with Claude Desktop and other AI assistants

🧪 Development
--------------

### Available Scripts

```bash
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

```bash
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](https://github.com/alexdiazdecerio/fastmail-mcp-server/blob/main/CONTRIBUTING.md) for details.

### Development Workflow

1.   Fork the repository
2.   Create a feature branch (`git checkout -b feature/amazing-feature`)
3.   Commit your changes (`git commit -m 'Add amazing feature'`)
4.   Push to the branch (`git push origin feature/amazing-feature`)
5.   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](https://github.com/alexdiazdecerio/fastmail-mcp-server/blob/main/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](mailto:hello@fastmail.com) • [📚 Documentation](https://github.com/alexdiazdecerio/fastmail-mcp-server/blob/main/docs) • [🐛 Report Bug](https://github.com/alexdiazdecerio/fastmail-mcp-server/issues) • [💡 Request Feature](https://github.com/alexdiazdecerio/fastmail-mcp-server/discussions)