Summary
Connects Claude to Kylas CRM's lead management API. You get tools to create leads, search and filter them by multiple criteria, and resolve lookups for users, products, and pipeline stages. It also includes a helper to fetch the full lead schema, including custom fields and picklist IDs, so Claude can build valid payloads on the fly. There's a bonus tool for finding idle leads based on days of inactivity. Requires a Kylas API key and runs over stdio. If you're managing a Kylas sales pipeline and want conversational access to lead operations without building your own integration, this covers the essentials.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Kylas CRM MCP Server (Lead Only)
Model Context Protocol server for Kylas CRM lead operations. Use it from Cursor, Claude Desktop, or any MCP client to create leads, search and filter leads, and look up users, products, and pipelines.
Features
- get_lead_field_instructions – Get lead schema (standard + custom fields, picklist IDs)
- create_lead – Create a lead with dynamic fields from user context
- search_leads – Search/filter leads by multiple criteria
- lookup_users – Resolve user names to IDs (for owner, created by, etc.)
- lookup_products – Resolve product names to IDs
- lookup_pipelines / get_pipeline_stages – Resolve pipeline and stage for open/closed/won leads
- search_idle_leads – Find leads with no activity for N days
Requirements
- Python 3.10+
- Kylas account and API key
Installation
pip install -e .
# or from PyPI (after publish): pip install kylas-crm-mcp-server
Configuration
Set environment variables (or use a .env file):
| Variable | Required | Description |
|---|---|---|
KYLAS_API_KEY | Yes | Your Kylas API key |
KYLAS_BASE_URL | No | API base URL (default: https://api.kylas.io/v1) |
Running the server
The server uses stdio transport (default for MCP). Run:
python -m kylas_crm_mcp
# or: python main.py (when developing from repo root)
MCP clients (e.g. Cursor) typically start this process and communicate via stdin/stdout.
Docker
docker build -t kylas-crm-mcp .
docker run -e KYLAS_API_KEY=your_key -i kylas-crm-mcp
Development
pip install -e ".[dev]"
pytest
Publishing to the MCP Marketplace
To publish this server to the official MCP Registry (so it appears in Cursor and other MCP clients):
- Publish the package to PyPI (the registry verifies ownership via your README).
- Install mcp-publisher and run
mcp-publisher login github, thenmcp-publisher publish.
See PUBLISHING.md for the full step-by-step guide.
License
See repository for license information.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
KYLAS_API_KEY*secretYour Kylas API key (required)
KYLAS_BASE_URLKylas API base URL (optional, default: https://api.kylas.io/v1)
Registryactive
Packagekylas-crm-mcp-server
TransportSTDIO
AuthRequired
UpdatedFeb 9, 2026
