playbooks

home / mcp / kit mcp server

Kit MCP Server

Provides access to Kit.com data through MCP, enabling subscribers, tags, sequences, broadcasts, forms, and webhooks management via natural language.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "aplaceforallmystuff-mcp-kit": {
      "command": "node",
      "args": [
        "/path/to/mcp-kit/dist/index.js"
      ],
      "env": {
        "KIT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can run an MCP server that lets Claude interact with Kit.com to manage subscribers, tags, sequences, broadcasts, forms, and more. This local, script-driven server enables natural-language control of Kit.com data and workflows from your preferred MCP client.

How to use

You will configure one or more MCP clients to connect to the Kit MCP server, then issue natural-language requests to perform actions such as listing subscribers, adding tags, enrolling subscribers in sequences, drafting broadcasts, and querying custom fields. The server accepts commands from standard input/output integrations and exposes a set of tools that map directly to Kit.com resources. Use plain language prompts like: “Show active subscribers from the last 30 days,” “Add this email to the welcome sequence,” or “List all my broadcasts.” The system will interpret your request and carry out the corresponding API actions through Kit.com.

How to install

Prerequisites you need before installation are Node.js 18 or newer and a Kit.com account with a v4 API key.

Option 1: Install from npm (recommended) - run the following commands in your terminal.

npx kit-mcp-server

Or install globally for easier access from any location.

npm install -g kit-mcp-server

Option 2: Clone the project and build locally.

git clone https://github.com/aplaceforallmystuff/mcp-kit.git
cd mcp-kit
npm install
npm run build

Additional setup and configuration

Create and configure an MCP client for Claude Desktop or Claude Code to connect to the local MCP server. You will point the client to the MCP script and provide your Kit.com API key.

Claude Desktop configuration example for macOS and Windows shows how to reference the local server script and pass the API key via environment variables.

{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Additional setup for Claude Code

You can add the Kit MCP server to Claude Code with a similar command flow, providing the API key as an environment variable.

claude mcp add kit -e KIT_API_KEY=your-api-key-here -- node /path/to/mcp-kit/dist/index.js
{
  "mcpServers": {
    "kit": {
      "command": "node",
      "args": ["/path/to/mcp-kit/dist/index.js"],
      "env": {
        "KIT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage examples

Once connected, use natural language prompts to manage your Kit.com resources. Examples include listing subscribers, adding tags, enrolling users in sequences, creating broadcasts, and querying for subscriber data with filters.

Development

For development, you can run in watch mode, build for production, and start the server from the built artifact.

npm run dev
```

```
npm run build
```

```
npm start

Troubleshooting

Ensure the KIT_API_KEY environment variable is set for your MCP configuration. If you encounter kit API errors, verify that your API key is valid, has the proper scopes for v4, and has not expired.

Notes

This MCP server focuses on Kit.com resources such as Subscribers, Tags, Sequences, Broadcasts, Forms, Custom Fields, and Webhooks. It supports common operations through a consistent MCP client interface.

Available tools

kit_get_account

Retrieve account information from Kit.com.

kit_list_subscribers

List subscribers with optional filters such as status, date ranges, and pagination.

kit_get_subscriber

Fetch a subscriber by their unique ID.

kit_create_subscriber

Create a new subscriber in Kit.com.

kit_update_subscriber

Update details for an existing subscriber.

kit_get_subscriber_tags

Get all tags associated with a subscriber.

kit_add_tag_to_subscriber

Add a tag to a subscriber.

kit_remove_tag_from_subscriber

Remove a tag from a subscriber.

kit_list_tags

List all available tags.

kit_get_tag

Get a specific tag by ID.

kit_create_tag

Create a new tag.

kit_update_tag

Rename or modify a tag.

kit_delete_tag

Delete a tag.

kit_list_tag_subscribers

List all subscribers associated with a specific tag.

kit_list_sequences

List all email sequences.

kit_get_sequence

Get details for a specific sequence.

kit_add_subscriber_to_sequence

Add a subscriber to a sequence.

kit_list_broadcasts

List all broadcasts.

kit_get_broadcast

Get details for a broadcast.

kit_create_broadcast

Create a new broadcast.

kit_update_broadcast

Update an existing broadcast.

kit_delete_broadcast

Delete a broadcast.

kit_list_forms

List all forms.

kit_get_form

Get details for a form.

kit_add_subscriber_to_form

Add a subscriber via a form.

kit_list_custom_fields

List all custom fields.

kit_list_webhooks

List configured webhooks.

kit_create_webhook

Create a new webhook.

kit_delete_webhook

Delete a webhook.