Buttondown MCP Server
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.
Integrations
Integrates with 1Password for secure API key management, allowing the retrieval of stored credentials for Buttondown authentication.
Supports creating email content in Markdown format when creating or updating newsletter drafts.
Supported package manager for installation of the Buttondown integration.
Buttondown API Integration
A comprehensive TypeScript integration for the Buttondown newsletter service, providing both a CLI interface and a Model Context Protocol (MCP) server for managing newsletters, drafts, and analytics.
Features
- Multiple Interfaces:
- Command Line Interface (CLI) for direct interaction
- Model Context Protocol (MCP) server for AI/LLM integration
- Programmatic TypeScript API for custom integrations
- Core Functionality:
- Email draft management (create, update, delete)
- Email scheduling system
- Analytics retrieval and formatting
- List management
- Tag management
- Security:
- 1Password integration for API key management
- Environment variable support
- Secure credential handling
- Developer Experience:
- Full TypeScript support
- Comprehensive type definitions
- Real API response-based types
- Built-in testing utilities
Installation
Configuration
The API key can be provided in two ways:
- Environment variable:Copy
- 1Password CLI (recommended):
- Store your API key in 1Password at
op://Development/Buttondown API/notesPlain
- The integration will automatically fetch it when needed
- Store your API key in 1Password at
Usage
CLI Interface
MCP Server
- Start the server:Copy
- Start with inspector (for development):Copy
Available MCP tools:
list_emails
: List all emails with optional status filteringCopycreate_draft
: Create a new email draftCopyget_analytics
: Get analytics for a specific emailCopyschedule_draft
: Schedule an email for sendingCopy
Programmatic Usage
Development
Testing
The project includes several types of tests:
- Unit tests for core functionality
- Integration tests for API interactions
- CLI command tests
- MCP server tests
Run tests with:
Project Structure
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
License
ISC License - See LICENSE for details
Acknowledgments
- Buttondown for their excellent newsletter service
- Model Context Protocol for the AI integration framework
This server cannot be installed
Provides AI/LLM integration with the Buttondown newsletter service, allowing management of drafts, scheduling emails, retrieving analytics, and other newsletter operations through the Model Context Protocol.