Back to the catalog

Kylas CRM

MCP server for Kylas CRM: create, search, and manage leads. Requires KYLAS_API_KEY.

Open source Open in the app JSON README (API)

About

MCP server for Kylas CRM: create, search, and manage leads. Requires KYLAS_API_KEY.

Details

Kind
MCP servers
Topic
Productivity
Publisher
akshaykylas94
Origin
official
Category
ferramentas
Transport
local
Version
1.0.0
Last push
2026-02-04T05:47:41Z
Repository state
ativo
Language
Python
Added
2026-08-29 03:02:24
Updated
2026-08-29 03:02:24
Origin id
io.github.akshaykylas94/kylas-crm

README

# 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.

<!-- mcp-name: io.github.akshaykylas94/kylas-crm -->

## 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](https://kylas.io) account and API key

## Installation

```bash
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:

```bash
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

```bash
docker build -t kylas-crm-mcp .
docker run -e KYLAS_API_KEY=your_key -i kylas-crm-mcp
```

## Development

```bash
pip install -e ".[dev]"
pytest
```

## License

See repository for license information.

More