keap-mcp-server
v1.0.2
Published
MCP server for the Keap CRM API (unified v1 + v2 endpoints)
Readme
Keap MCP Server
A Model Context Protocol (MCP) server that provides unified access to the Keap CRM API (both v1 and v2 endpoints) through a single, logically organized interface.
This server exposes 80+ tools covering every major Keap resource, including critical v1-only features like webhooks, appointments, and campaign goal triggers that are missing from the v2 API.
Installation
npm install
npm run buildConfiguration
Set your Keap API key as an environment variable:
export KEAP_API_KEY="KeapAK-your-api-key-here"Usage
With Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"keap": {
"command": "node",
"args": ["/path/to/keap-mcp-server/dist/index.js"],
"env": {
"KEAP_API_KEY": "KeapAK-your-api-key-here"
}
}
}
}With Manus
Add as an MCP server configuration:
{
"name": "keap",
"command": "node",
"args": ["/path/to/keap-mcp-server/dist/index.js"],
"env": {
"KEAP_API_KEY": "KeapAK-your-api-key-here"
}
}Standalone (stdio)
KEAP_API_KEY="KeapAK-..." node dist/index.jsDevelopment
KEAP_API_KEY="KeapAK-..." npx tsx src/index.tsTool Reference
CRM (25 tools)
| Tool | Description |
|---|---|
| list_contacts | List contacts with filtering and pagination |
| get_contact | Retrieve a specific contact |
| create_contact | Create a new contact |
| update_contact | Update an existing contact |
| delete_contact | Delete a contact |
| get_contact_model | Get the contact data model (including custom fields) |
| create_contact_custom_field | Create a custom field on the Contact model |
| get_contact_emails | List emails sent to a contact (v1) |
| get_contact_tags | List tags on a contact (v1) |
| link_contacts | Create a link between two contacts |
| list_companies | List companies |
| get_company | Retrieve a specific company |
| create_company | Create a new company |
| update_company | Update a company |
| delete_company | Delete a company |
| list_tags | List all tags |
| get_tag | Retrieve a specific tag |
| create_tag | Create a new tag |
| update_tag | Update a tag |
| delete_tag | Delete a tag |
| apply_tag_to_contacts | Apply a tag to contacts |
| remove_tag_from_contacts | Remove a tag from contacts |
| list_tagged_contacts | List contacts with a specific tag |
| create_tag_category | Create a tag category |
| list_notes / get_note / create_note / update_note / delete_note | Full CRUD for notes |
Sales (7 tools)
| Tool | Description |
|---|---|
| list_opportunities | List opportunities/deals |
| get_opportunity | Retrieve a specific opportunity |
| create_opportunity | Create a new opportunity |
| update_opportunity | Update an opportunity |
| delete_opportunity | Delete an opportunity |
| list_pipelines | List sales pipelines |
| get_pipeline | Retrieve a specific pipeline |
Marketing (16 tools)
| Tool | Description |
|---|---|
| list_campaigns | List all campaigns |
| get_campaign | Retrieve a specific campaign |
| list_campaign_sequences | List sequences in a campaign |
| add_contacts_to_campaign_sequence | Add contacts to a campaign sequence |
| remove_contacts_from_campaign_sequence | Remove contacts from a sequence |
| achieve_campaign_goal | Trigger a campaign goal (v1 only — critical for automation) |
| list_automations | List automations |
| get_automation | Retrieve a specific automation |
| add_contact_to_automation | Add contacts to an automation |
| list_emails / get_email / create_email / delete_email | Email management |
| list_webforms | List webforms |
| get_webform_html | Get webform HTML |
E-Commerce (18 tools)
| Tool | Description |
|---|---|
| list_orders / get_order / create_order / delete_order | Order management |
| list_order_items | List items in an order |
| list_order_payments | List payments for an order |
| list_transactions | List transactions (v1) |
| list_products / get_product / create_product / update_product / delete_product | Product management |
| list_subscriptions / get_subscription | Subscription management |
| list_payment_method_configs | List payment configurations |
Affiliates (8 tools)
| Tool | Description |
|---|---|
| list_affiliates / get_affiliate / create_affiliate | Affiliate management |
| list_affiliate_commissions | List commissions (v1) |
| list_affiliate_programs | List commission programs (v1) |
| list_affiliate_redirects | List redirect links (v1) |
| list_affiliate_clawbacks | List clawbacks (v1) |
| list_affiliate_payments | List payments (v1) |
Calendar (11 tools)
| Tool | Description |
|---|---|
| list_appointments / get_appointment / create_appointment / update_appointment / delete_appointment | Full appointment CRUD (v1 only) |
| list_tasks / get_task / create_task / update_task / delete_task | Full task CRUD |
| search_tasks | Advanced task search (v1) |
Events — Webhooks (7 tools)
| Tool | Description |
|---|---|
| list_webhooks | List all webhook subscriptions (v1) |
| create_webhook | Create a webhook subscription (v1) |
| get_webhook | Retrieve a webhook (v1) |
| update_webhook | Update a webhook (v1) |
| delete_webhook | Delete a webhook (v1) |
| list_webhook_event_types | List available event types (v1) |
| verify_webhook | Verify a webhook (v1) |
Admin (18 tools)
| Tool | Description |
|---|---|
| get_account_profile / update_account_profile | Account profile management |
| get_app_configuration / get_app_status | Application settings |
| list_users / get_user / create_user | User management (create is v1 only) |
| get_user_info / get_user_signature | User details |
| list_files / get_file / upload_file / delete_file | File management |
| list_reports / get_report / run_report | Reporting |
| list_countries / list_provinces | Locale data |
| get_contact_option_types | Contact option types |
Raw API Access (1 tool)
| Tool | Description |
|---|---|
| keap_api_request | Make a raw request to any Keap v1 or v2 endpoint |
Architecture
keap-mcp-server/
├── src/
│ ├── index.ts # Entry point, server setup
│ ├── keap-client.ts # HTTP client for Keap API
│ └── tools/
│ ├── crm.ts # Contacts, Companies, Tags, Notes
│ ├── sales.ts # Opportunities, Pipelines
│ ├── marketing.ts # Campaigns, Automations, Email, Webforms
│ ├── ecommerce.ts # Orders, Products, Subscriptions
│ ├── affiliates.ts # Affiliate management
│ ├── calendar.ts # Appointments, Tasks
│ ├── events.ts # Webhooks (REST Hooks)
│ ├── admin.ts # Account, Users, Files, Reporting
│ └── raw.ts # Generic API request tool
├── package.json
├── tsconfig.json
└── README.mdLicense
MIT
