Summary
This server is deprecated and should not be used. Kit.com now ships official first-party MCP servers that cover more of the API v4 surface, including analytics, commerce, segments, and bulk operations. The official servers handle authentication for you and stay current with API changes. If you're managing a Kit.com email list through Claude, use the official Kit MCP at app.kit.com/mcp instead. This community version predates Kit's official support and only exposes basic subscriber, tag, sequence, and broadcast operations. The maintainer has stopped work on it and recommends migrating to Kit's maintained tooling.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
29 tools
KIT_ADD_SUBSCRIBER_TO_FORMTool to add a subscriber to a specific form by ID. Use after confirming form and subscriber IDs.3 params
Tool to add a subscriber to a specific form by ID. Use after confirming form and subscriber IDs.
Parameters* required
idintegerThe ID of the subscriber to add to the form.
form_idintegerThe ID of the form to which the subscriber will be added.
referrerstringThe URL from which the subscriber was referred.
KIT_CREATE_CUSTOM_FIELDTool to create a new custom field for subscriber data. Use when you need to store extra attributes for subscribers.1 params
Tool to create a new custom field for subscriber data. Use when you need to store extra attributes for subscribers.
Parameters* required
labelstringThe display label for the custom field (e.g., 'Favorite Color').
KIT_CREATE_TAGTool to create a new tag in the account. Use when you need a custom label to segment subscribers. Use after confirming tag uniqueness to avoid duplicates. Example: "Create a tag called 'VIP' for premium customers."1 params
Tool to create a new tag in the account. Use when you need a custom label to segment subscribers. Use after confirming tag uniqueness to avoid duplicates. Example: "Create a tag called 'VIP' for premium customers."
Parameters* required
namestringName of the tag to be created.
KIT_CREATE_WEBHOOKTool to create a new webhook subscription. Use when you need subscriber or purchase event notifications.2 params
Tool to create a new webhook subscription. Use when you need subscriber or purchase event notifications.
Parameters* required
eventobjectWebhook event configuration.
target_urlstringURL to receive webhook POST notifications.
KIT_DELETE_BROADCASTTool to delete a specific broadcast. Use when you need to permanently remove a broadcast by ID (after confirming the ID). Example prompt: "Delete broadcast with ID 123"1 params
Tool to delete a specific broadcast. Use when you need to permanently remove a broadcast by ID (after confirming the ID). Example prompt: "Delete broadcast with ID 123"
Parameters* required
idintegerUnique identifier of the broadcast to delete
KIT_DELETE_CUSTOM_FIELDTool to delete a specific custom field. Use after confirming the custom field ID is correct. Deletes the field permanently.1 params
Tool to delete a specific custom field. Use after confirming the custom field ID is correct. Deletes the field permanently.
Parameters* required
idintegerUnique identifier of the custom field to delete
KIT_DELETE_SUBSCRIBERTool to delete (unsubscribe) a subscriber by ID. Use when you need to remove a subscriber from all sequences and forms after confirming the subscriber exists.1 params
Tool to delete (unsubscribe) a subscriber by ID. Use when you need to remove a subscriber from all sequences and forms after confirming the subscriber exists.
Parameters* required
idintegerUnique identifier of the subscriber to delete
KIT_DELETE_TAGTool to delete a tag by ID. Use when you need to remove obsolete or incorrect tags after confirming the tag exists.1 params
Tool to delete a tag by ID. Use when you need to remove obsolete or incorrect tags after confirming the tag exists.
Parameters* required
idintegerUnique identifier of the tag to delete
KIT_DELETE_WEBHOOKTool to delete a webhook by ID. Use when you want to permanently remove a webhook after confirming its ID.1 params
Tool to delete a webhook by ID. Use when you want to permanently remove a webhook after confirming its ID.
Parameters* required
idintegerUnique identifier of the webhook to delete
KIT_GET_ACCOUNTTool to retrieve current account information. Use after validating API key to fetch account ID, plan type, primary email, and timezone details.
Tool to retrieve current account information. Use after validating API key to fetch account ID, plan type, primary email, and timezone details.
No parameter schema in public metadata yet.
KIT_GET_ACCOUNT_COLORSTool to retrieve list of colors associated with the account. Use after confirming authentication to fetch account-specific color palette.
Tool to retrieve list of colors associated with the account. Use after confirming authentication to fetch account-specific color palette.
No parameter schema in public metadata yet.
KIT_GET_BROADCASTTool to retrieve details of a specific broadcast by ID. Use when you have a valid broadcast ID and need its metadata.1 params
Tool to retrieve details of a specific broadcast by ID. Use when you have a valid broadcast ID and need its metadata.
Parameters* required
idintegerUnique identifier of the broadcast to retrieve
KIT_GET_BROADCAST_STATSTool to retrieve statistics for a specific broadcast by ID. Use after a broadcast has been sent to monitor performance.1 params
Tool to retrieve statistics for a specific broadcast by ID. Use after a broadcast has been sent to monitor performance.
Parameters* required
idintegerUnique identifier of the broadcast to fetch statistics for
KIT_GET_CREATOR_PROFILETool to retrieve the creator profile information for the account. Use when you need creator metadata (bio, avatar, social links) before publishing or customizing content.
Tool to retrieve the creator profile information for the account. Use when you need creator metadata (bio, avatar, social links) before publishing or customizing content.
No parameter schema in public metadata yet.
KIT_GET_EMAIL_STATSTool to retrieve email statistics for the account. Use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
Tool to retrieve email statistics for the account. Use after confirming authentication to fetch metrics on emails (sent, opened, clicked) over the last 90 days.
No parameter schema in public metadata yet.
KIT_LIST_BROADCASTSTool to retrieve a paginated list of all broadcasts. Use when you need to enumerate or review broadcast summaries with cursor-based pagination.4 params
Tool to retrieve a paginated list of all broadcasts. Use when you need to enumerate or review broadcast summaries with cursor-based pagination.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page; must be between 1 and 500.
include_total_countstringIf set to 'true', includes the total count of records in the response.
KIT_LIST_CUSTOM_FIELDSTool to retrieve a paginated list of custom fields. Use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.4 params
Tool to retrieve a paginated list of custom fields. Use after confirming you need to enumerate or inspect all custom fields with cursor-based pagination.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page; defaults to 500 if not specified.
include_total_countstringIf set to 'true', includes the total count of records in the response.
KIT_LIST_FORMSTool to list all forms. Use when you need to fetch forms with optional filters and pagination.6 params
Tool to list all forms. Use when you need to fetch forms with optional filters and pagination.
Parameters* required
typestringFilter forms by type.one of
embed · hostedafterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
statusstringFilter forms by status (e.g., 'active', 'archived').
per_pageintegerNumber of forms to return per page.
include_total_countstringIf set to 'true', includes the total count of forms in the response.one of
true · falseKIT_LIST_SEGMENTSTool to retrieve a paginated list of segments. Use when you need to enumerate segments with cursor-based pagination for further processing or display.4 params
Tool to retrieve a paginated list of segments. Use when you need to enumerate segments with cursor-based pagination for further processing or display.
Parameters* required
afterstringCursor for pagination; returns results after this cursor.
beforestringCursor for pagination; returns results before this cursor.
per_pageintegerNumber of segments to return per page (min 1).
include_total_countstringIf set to 'true', includes the total count of segments in the response.one of
true · falseKIT_LIST_SEQUENCESTool to retrieve a paginated list of all sequences. Use when you need to enumerate sequences with pagination for further processing or display.4 params
Tool to retrieve a paginated list of all sequences. Use when you need to enumerate sequences with pagination for further processing or display.
Parameters* required
afterstringCursor for pagination; returns results after the specified cursor.
beforestringCursor for pagination; returns results before the specified cursor.
per_pageintegerNumber of results per page (max 500).
include_total_countstringIf set to 'true', includes the total count in the pagination.one of
true · falseKIT_LIST_SUBSCRIBERSTool to retrieve a list of subscribers. Use when you need to fetch subscriber records with optional filtering, sorting, and pagination.12 params
Tool to retrieve a list of subscribers. Use when you need to fetch subscriber records with optional filtering, sorting, and pagination.
Parameters* required
afterstringCursor for pagination; returns subscribers after this cursor.
beforestringCursor for pagination; returns subscribers before this cursor.
statusstringFilter by subscriber status (e.g., 'active' or 'inactive').
per_pageintegerNumber of subscribers to return per page (min 1).
sort_fieldstringField by which to sort the subscribers.
sort_orderstringOrder in which to sort the results.one of
asc · desccreated_afterstringFilter to subscribers created after this date (YYYY-MM-DD).
email_addressstringExact email address to filter by.
updated_afterstringFilter to subscribers updated after this date (YYYY-MM-DD).
created_beforestringFilter to subscribers created before this date (YYYY-MM-DD).
updated_beforestringFilter to subscribers updated before this date (YYYY-MM-DD).
include_total_countstringIf set to 'true', includes the total count of subscribers in the response.one of
true · falseKIT_LIST_SUBSCRIBERS_FOR_FORMTool to retrieve subscribers for a specific form by ID. Use when you need to page or filter subscribers of a form.10 params
Tool to retrieve subscribers for a specific form by ID. Use when you need to page or filter subscribers of a form.
Parameters* required
afterstringCursor for pagination; returns results after this cursor.
beforestringCursor for pagination; returns results before this cursor.
statusstringFilter subscribers by status (e.g., 'active').
form_idintegerID of the form whose subscribers you want to retrieve.
per_pageintegerNumber of results to return per page (min 1).
added_afterstringReturn subscribers added to the form after this date/time (ISO 8601).
added_beforestringReturn subscribers added to the form before this date/time (ISO 8601).
created_afterstringReturn subscribers created after this date/time (ISO 8601).
created_beforestringReturn subscribers created before this date/time (ISO 8601).
include_total_countstringIf 'true', includes the total count of subscribers in the response.one of
true · falseKIT_LIST_TAGSTool to retrieve a list of all tags. Use when you need a complete inventory of tags for the Kit account.
Tool to retrieve a list of all tags. Use when you need a complete inventory of tags for the Kit account.
No parameter schema in public metadata yet.
KIT_LIST_TAG_SUBSCRIBERSTool to retrieve subscribers for a specific tag. Use after confirming the tag ID when you need to list subscribers associated with a tag.10 params
Tool to retrieve subscribers for a specific tag. Use after confirming the tag ID when you need to list subscribers associated with a tag.
Parameters* required
afterstringCursor for pagination; returns subscribers after this cursor.
beforestringCursor for pagination; returns subscribers before this cursor.
statusstringFilter by subscriber status ('active' or 'inactive').
tag_idintegerUnique identifier of the tag to retrieve subscribers for
per_pageintegerNumber of subscribers to return per page (min 1).
tagged_afterstringFilter to subscribers tagged after this timestamp (ISO 8601).
created_afterstringFilter to subscribers created after this timestamp (ISO 8601).
tagged_beforestringFilter to subscribers tagged before this timestamp (ISO 8601).
created_beforestringFilter to subscribers created before this timestamp (ISO 8601).
include_total_countstringIf set to 'true', includes total count of subscribers in the response.one of
true · falseKIT_TAG_SUBSCRIBERTool to associate a subscriber with a specific tag by ID. Use after confirming tag and subscriber IDs when tagging a subscriber.2 params
Tool to associate a subscriber with a specific tag by ID. Use after confirming tag and subscriber IDs when tagging a subscriber.
Parameters* required
tag_idintegerID of the tag to assign
subscriber_idintegerID of the subscriber to tag
KIT_TAG_SUBSCRIBER_BY_EMAILTool to associate a subscriber with a tag using an email address. Use when you have a tag ID and subscriber email ready. Use after confirming both resources exist.2 params
Tool to associate a subscriber with a tag using an email address. Use when you have a tag ID and subscriber email ready. Use after confirming both resources exist.
Parameters* required
tag_idintegerThe ID of the tag to assign to the subscriber
email_addressstringThe subscriber's email address
KIT_UPDATE_ACCOUNT_COLORSTool to update the list of colors for the account. Use when customizing your Kit account's color palette for broadcasts and templates.1 params
Tool to update the list of colors for the account. Use when customizing your Kit account's color palette for broadcasts and templates.
Parameters* required
colorsarrayList of hex color codes to set for the account (e.g., '#008000', '#FF0000').
KIT_UPDATE_CUSTOM_FIELDTool to update a custom field's label. Use after listing or retrieving custom fields and confirming the field ID to rename.2 params
Tool to update a custom field's label. Use after listing or retrieving custom fields and confirming the field ID to rename.
Parameters* required
idintegerUnique identifier of the custom field to update
labelstringNew label for the custom field
KIT_UPDATE_TAGTool to update a tag's name by ID. Use after retrieving tag ID and confirming the new name.2 params
Tool to update a tag's name by ID. Use after retrieving tag ID and confirming the new name.
Parameters* required
idintegerUnique identifier of the tag to update
namestringNew name for the tag
MCP Kit Server
An MCP (Model Context Protocol) server that connects AI assistants like Claude to the Kit.com (formerly ConvertKit) email marketing platform. Manage your email lists, subscribers, broadcasts, sequences, and more through natural language.
[!WARNING] This project is deprecated and no longer maintained. Kit now ships official, first-party MCP servers that supersede it with broader API coverage and managed authentication. Please migrate — see below.
⚠️ Deprecated — use Kit's official MCP servers
This community server was built before Kit offered its own MCP. Kit now maintains official servers that cover far more of the Kit API v4 surface (including analytics, commerce, segments, and bulk operations), handle auth for you, and stay current with API changes. New and existing users should migrate.
| Use case | Official server | URL |
|---|---|---|
| Act on your Kit account — subscribers, tags, sequences, broadcasts, analytics, commerce… | Kit MCP | https://app.kit.com/mcp |
| Give a coding agent live access to Kit's developer docs + API | Kit Developer Docs MCP | https://developers.kit.com/mcp |
Migrate in Claude Code
# Remove this deprecated server (if you added it as "kit")
claude mcp remove kit
# Add the official operational Kit MCP
claude mcp add --transport http kit https://app.kit.com/mcp
# Optional: add Kit's developer-docs MCP for building integrations
claude mcp add --transport http kit-docs https://developers.kit.com/mcp
Official setup guides (Claude Desktop, Cursor, Windsurf, Cline, and more): https://developers.kit.com/mcp/kit-developer-docs-mcp/mcp/overview
📦 Legacy documentation (for historical reference)
Why Use This?
If you run a newsletter or email marketing on Kit.com, this MCP server lets you:
- Manage subscribers - List, create, update, and organize your email subscribers
- Handle tags efficiently - Create tags, add/remove tags from subscribers, list subscribers by tag
- Work with sequences - View email sequences and add subscribers to automated sequences
- Create broadcasts - Draft and manage email campaigns
- Analyze your list - Query subscriber data with filters (status, date ranges, custom fields)
- Automate workflows - Let Claude handle repetitive email marketing tasks
Features
| Category | Tools |
|---|---|
| Account | Get account information |
| Subscribers | List, get, create, update, manage tags |
| Tags | List, create, update, delete, get subscribers by tag |
| Sequences | List, get, add subscribers |
| Broadcasts | List, get, create, update, delete |
| Forms | List, get, add subscribers |
| Custom Fields | List available fields |
| Webhooks | List, create, delete |
Complete Tool Reference
Account
kit_get_account- Get Kit.com account information
Subscribers (7 tools)
kit_list_subscribers- List subscribers with filters (status, date ranges, pagination)kit_get_subscriber- Get a specific subscriber by IDkit_create_subscriber- Create a new subscriberkit_update_subscriber- Update subscriber detailskit_get_subscriber_tags- Get all tags for a subscriberkit_add_tag_to_subscriber- Add a tag to a subscriberkit_remove_tag_from_subscriber- Remove a tag from a subscriber
Tags (6 tools)
kit_list_tags- List all tagskit_get_tag- Get a specific tagkit_create_tag- Create a new tagkit_update_tag- Rename a tagkit_delete_tag- Delete a tagkit_list_tag_subscribers- List all subscribers with a specific tag
Sequences (3 tools)
kit_list_sequences- List all email sequenceskit_get_sequence- Get sequence detailskit_add_subscriber_to_sequence- Add subscriber to a sequence
Broadcasts (5 tools)
kit_list_broadcasts- List all broadcastskit_get_broadcast- Get broadcast detailskit_create_broadcast- Create a new broadcastkit_update_broadcast- Update a broadcastkit_delete_broadcast- Delete a broadcast
Forms (3 tools)
kit_list_forms- List all formskit_get_form- Get form detailskit_add_subscriber_to_form- Add subscriber via form
Custom Fields (1 tool)
kit_list_custom_fields- List all custom fields
Webhooks (3 tools)
kit_list_webhooks- List configured webhookskit_create_webhook- Create a new webhookkit_delete_webhook- Delete a webhook
Prerequisites
- Node.js 18+
- A Kit.com account
- Your Kit.com API key (v4 API)
Installation
Option 1: Install from npm (recommended)
npx kit-mcp-server
Or install globally:
npm install -g kit-mcp-server
Option 2: Clone and Build
git clone https://github.com/aplaceforallmystuff/mcp-kit.git
cd mcp-kit
npm install
npm run build
Configuration
1. Get Your Kit.com API Key
- Log in to Kit.com
- Navigate to Settings > Developer
- Create a new API key or copy an existing v4 API key
2. Configure Your MCP Client
For Claude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"kit": {
"command": "node",
"args": ["/path/to/mcp-kit/dist/index.js"],
"env": {
"KIT_API_KEY": "your-api-key-here"
}
}
}
}
For Claude Code
claude mcp add kit -e KIT_API_KEY=your-api-key-here -- node /path/to/mcp-kit/dist/index.js
Or add to ~/.claude.json:
{
"mcpServers": {
"kit": {
"command": "node",
"args": ["/path/to/mcp-kit/dist/index.js"],
"env": {
"KIT_API_KEY": "your-api-key-here"
}
}
}
}
Usage Examples
Once configured, you can interact with Kit.com through natural language:
Subscriber Management
"Show me all active subscribers from the last 30 days"
"Create a new subscriber with email user@example.com and tag them as 'newsletter'"
"What tags does subscriber@example.com have?"
Tag Operations
"List all my tags and how many subscribers each has"
"Create a tag called 'VIP Customers'"
"Add the 'engaged' tag to all subscribers who signed up this month"
Email Sequences
"Show me all my email sequences"
"Add user@example.com to the welcome sequence"
Broadcasts
"Create a draft broadcast with subject 'Weekly Update' and preview text 'This week in AI...'"
"List all my recent broadcasts and their stats"
Forms
"Show me all active forms"
"Add a subscriber to my main signup form"
Development
# Run in development mode (watches for changes)
npm run dev
# Build for production
npm run build
# Run the built version
npm start
Troubleshooting
"KIT_API_KEY environment variable is required"
Ensure you have set the KIT_API_KEY environment variable in your MCP configuration.
"Kit API error (401)"
Your API key is invalid or expired. Generate a new one from Kit.com Settings > Developer.
"Kit API error (403)"
Your API key doesn't have permission for this operation. Check that you're using a v4 API key with appropriate scopes.
"Kit API error (404)"
The resource (subscriber, tag, broadcast, etc.) was not found. Verify the ID is correct.
"Kit API error (422)"
Invalid request data. Check that email addresses are valid and required fields are provided.
API Reference
This server uses the Kit.com API v4. All tools support pagination where applicable using per_page and after cursor parameters.
Contributing
This project is deprecated and not accepting contributions. Please use Kit's official MCP servers instead.
License
MIT License - see LICENSE for details.
Links
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
KIT_API_KEY*secretYour Kit.com API key (v4)