About Kylas CRM
Kylas CRM is an MCP server for users managing CRM leads through MCP clients. It creates, searches, and filters leads, and looks up related users, products, and pipeline details.
Key features
- 01Get lead field instructions
- 02Create leads
- 03Search and filter leads
- 04Resolve user and product IDs
- 05Look up pipelines and stages
- 06Find idle leads
Use cases
- 01Create leads from user context
- 02Filter leads by multiple criteria
- 03Resolve owner, product, and stage names to IDs
MCP support
It exposes Kylas CRM lead operations and related lookup tools to MCP clients over stdio. A KYLAS_API_KEY is required.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
uvx kylas-crm-mcpKYLAS_API_KEYSecretYour Kylas API key (required)KYLAS_BASE_URLKylas API base URL (optional, default: https://api.kylas.io/v1)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEKylas 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
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
License
See repository for license information.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.