README.md
MCP server for the Keila newsletter API
keila-mcp
MCP server for the Keila newsletter API. Lets Claude manage contacts, campaigns, segments, and senders.
Install
claude mcp add -s user keila \
-e KEILA_API_KEY=$(op read "op://kube/Keila/api_key") \
-e KEILA_URL=https://mail.korroni.com \
-- uvx --from git+https://github.com/gwbischof/keila-mcp keila-mcp
Tools
| Tool | Description |
|---|---|
list_contacts |
List all contacts with pagination |
get_contact |
Fetch a contact by ID |
create_contact |
Create a new contact |
update_contact |
Update a contact |
delete_contact |
Delete a contact |
list_campaigns |
List all campaigns |
get_campaign |
Fetch a campaign by ID |
create_campaign |
Create a new campaign (does not send) |
update_campaign |
Update a campaign |
delete_campaign |
Delete a campaign |
send_campaign |
Send a campaign immediately |
schedule_campaign |
Schedule a campaign for future delivery |
list_segments |
List all segments |
create_segment |
Create a segment with a filter |
delete_segment |
Delete a segment |
list_senders |
List configured senders |
list_forms |
List signup forms |
Environment Variables
| Variable | Default | Description |
|---|---|---|
KEILA_URL |
https://mail.korroni.com |
Keila instance URL |
KEILA_API_KEY |
API key (create in Keila dashboard) |
Tools (17)
list_contactsList all contacts with paginationget_contactFetch a contact by IDcreate_contactCreate a new contactupdate_contactUpdate a contactdelete_contactDelete a contactlist_campaignsList all campaignsget_campaignFetch a campaign by IDcreate_campaignCreate a new campaign (does not send)update_campaignUpdate a campaigndelete_campaignDelete a campaignsend_campaignSend a campaign immediatelyschedule_campaignSchedule a campaign for future deliverylist_segmentsList all segmentscreate_segmentCreate a segment with a filterdelete_segmentDelete a segmentlist_sendersList configured senderslist_formsList signup formsEnvironment Variables
KEILA_URLKeila instance URLKEILA_API_KEYrequiredAPI key (create in Keila dashboard)Configuration
claude_desktop_config.json
{"mcpServers": {"keila": {"command": "uvx", "args": ["keila-mcp"], "env": {"KEILA_API_KEY": "your_api_key", "KEILA_URL": "https://mail.your-instance.com"}}}}Try it
→List all my current newsletter campaigns and their status.
→Create a new contact with the email test@example.com.
→Schedule the latest draft campaign to be sent next Monday at 9 AM.
→Show me all the segments I have configured in Keila.