Skip to main content
Glama
alexdiazdecerio

Fastmail MCP Server

README.md

๐Ÿงช 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)