1
Add it to Claude Code
claude mcp add -e "KYLAS_API_KEY=${KYLAS_API_KEY}" kylas-crm -- python -m kylas_crm_mcpRequired:
KYLAS_API_KEY+ 1 optional2
Make your agent remember this setup
kylas-crm's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Retrieve lead schema including custom fields and picklist IDs
- Create new leads using dynamic field mapping
- Advanced lead searching and filtering capabilities
- Resolve entity IDs for users, products, and pipelines
- Identify idle leads based on inactivity duration
Tools 8
get_lead_field_instructionsGet lead schema including standard and custom fields and picklist IDs.create_leadCreate a lead with dynamic fields from user context.search_leadsSearch and filter leads by multiple criteria.lookup_usersResolve user names to IDs.lookup_productsResolve product names to IDs.lookup_pipelinesResolve pipeline names to IDs.get_pipeline_stagesGet stages for a specific pipeline.search_idle_leadsFind leads with no activity for a specified number of days.Environment Variables
KYLAS_API_KEYrequiredYour Kylas API keyKYLAS_BASE_URLAPI base URLTry it
→Find all leads that have been idle for more than 30 days.
→Create a new lead for John Doe at Acme Corp with the source set to Website.
→Search for leads assigned to the sales representative named Sarah.
→List all stages available in the main sales pipeline.
Original README from akshaykylas94/MCP
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
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.