Mmcp.market

Kylas CRM MCP server

by kylastech·io.github.kylastech/kylas-crm·v1.0.4·12 stars

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

A85/100grade A
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
Growing

12 stars17 downloads/wk

Reviews

Write one

Nobody has reviewed Kylas CRM yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Kylas CRM tools (14, 2 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • create_leadwrite action

    Create a lead in Kylas CRM with only the fields the user wants (no static field list).

  • get_current_user

    Get the current authenticated user's profile from Kylas (GET /users/me). Call this whenever a date or datetime-related query is involved. Returns timezone (IANA, e.g. Asia/Calcutta), recordActions (call, email, sms, etc.), name, and other profile fields. - For filtering (search_leads, search_idle_leads): use the returned timezone as the timeZone in date/datetime filters; keep the user's date/datet

  • get_lead

    Get full details of a lead by ID (GET /leads/{id}). Use when the user asks for complete lead info, lead details, or to view a specific lead. lead_id: The lead ID (e.g. from search_leads or search_leads_by_term results).

  • get_lead_field_instructions

    Get all lead fields for the current tenant. CALL THIS FIRST before creating a lead. Returns a cheat sheet with API names (standard fields), Field IDs (custom fields), and Picklist Option IDs. Use this to build field_values for create_lead based on what the user wants—do not use static fields.

  • get_pipeline_details

    Get full pipeline details by ID (GET /pipelines/{id}): stages plus unqualifiedReasons and lostReasons. Call this when moving a lead to Closed Lost or Closed Unqualified. Present the relevant reasons list to the user, ask them to pick one, then call update_lead with pipelineStageReason set to that exact string (e.g. "No followup", "Booked with competitor"). pipeline_id: The pipeline ID (from the le

  • get_pipeline_stages

    Get stages for a pipeline. Call this only after the user has confirmed which pipeline to use (from lookup_pipelines). Do not call before pipeline confirmation. Returns pipeline name and list of stages for that pipeline only, with id, name, and forecastingType (OPEN, CLOSED_WON, CLOSED_LOST, CLOSED_UNQUALIFIED). Use the stage IDs in search_leads: filters [{"field": "pipeline", "operator": "equal",

  • lookup_pipelines

    Look up pipelines by name (for leads). Use when the user asks for leads by stage (e.g. open/closed/won/lost) but does not specify which pipeline. - Call this first; do NOT call get_pipeline_stages until after the user confirms the pipeline. - Present the pipeline(s) (id and name) and ask the user which pipeline they mean. If only one pipeline is found, still ask for confirmation. - Only after the

  • lookup_products

    Look up products by name. Use this BEFORE filtering leads by product when the user gives a product name. - If one product is found, use that product's ID in search_leads (e.g. {"field": "products", "operator": "equal", "value": <id>}). - If multiple products are found, ask the user which product they mean (list the options), then use the chosen product's ID in search_leads. query: Search string. U

  • lookup_users

    Look up users by name, or list all users in the system. - Use return_all=True (with query "name:" or empty) to fetch all users in one response (all pages combined). - For name search: query in field:value form (e.g. "firstName:last", "name:Last"). If one user is found, use that ID in search_leads; if multiple, ask which one. query: Search string (e.g. "firstName:last", "name:Last"). Use "name:" or

  • parse_datetime_to_utc_iso_tool

    Parse a datetime string in the user's timezone and return UTC ISO string for the Kylas API. Call get_current_user first to get the user's timezone. Use the returned string in create_lead field_values for date/datetime fields. Example: user says "create lead with follow-up 11th Feb 2026 at 7:30 AM" → get_current_user → timezone Asia/Calcutta → parse_datetime_to_utc_iso_tool("11 Feb 2026 7:30 AM", "

  • search_idle_leads

    Search for idle/stagnant leads: no activity for at least the given number of days. Uses both updatedAt and latestActivityCreatedAt; a lead is returned only when BOTH dates are on or before (today − days), so the effective last activity is before the threshold.

  • search_leads

    Search/filter leads. Only fields marked [FILTERABLE] in get_lead_field_instructions can be used. Call get_lead_field_instructions first to get filterable fields and their types.

  • search_leads_by_term

    Search leads by a single term across multiple fields (firstName, lastName, companyName, phoneNumbers, emails, etc.). Use this when the user asks for "leads with X", "leads containing Y", or "leads named Z" without specifying which field to filter on. For filtering by a specific field (e.g. "leads where phone number is X"), use search_leads instead.

  • update_leadwrite action

    Update a lead in Kylas CRM. Fetches the lead first, merges your field_values into it, then PUTs the full body. Same field_values format as create_lead. Call get_lead_field_instructions first for API names and custom field internal names. For owner: use lookup_users to get the user ID, then pass ownerId: <id> in field_values.

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 21 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

Install Kylas CRM in Claude Code, Cursor or VS Code

claude mcp add kylas-crm -- uvx kylas-crm-mcp-server
Add to Cursor

What the publisher says

From the Kylas CRM repository's README, as published. We do not edit it. Read it on GitHub

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.kylastech/kylas-crm -->

Features

  • getleadfieldinstructions** – Get lead schema (standard + custom fields, picklist IDs)
  • createlead** – Create a lead with dynamic fields from user context
  • searchleads** – Search/filter leads by multiple criteria
  • lookupusers** – Resolve user names to IDs (for owner, created by, etc.)
  • lookupproducts** – Resolve product names to IDs
  • lookuppipelines / getpipelinestages** – Resolve pipeline and stage for open/closed/won leads
  • searchidleleads – 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):

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):

  1. Publish the package to PyPI (the registry verifies ownership via your README).
  2. Install mcp-publisher and run mcp-publisher login github, then mcp-publisher publish.

See PUBLISHING.md for the full step-by-step guide.

License

See repository for license information.

Nothing above is checked by us. What we check is on the safety report.

Kylas CRM: common questions

Is Kylas CRM MCP server safe?
Yes, by our scan: it is graded A (85/100). Read the Kylas CRM safety report
How do I install Kylas CRM?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Kylas CRM need an API key?
Yes. The registry entry asks for KYLAS_API_KEY.
Is Kylas CRM maintained?
The last commit was 36 days ago (2026-09-07). The latest release is v1.0.4.
What can I use instead of Kylas CRM?
Servers from other publishers that do the same job: Salesforce MCP server, Follow Up Boss MCP server and Gambot WhatsApp Business API MCP server. Compare all Kylas CRM alternatives.

Alternatives to Kylas CRM

Same job from other publishers: the closest match first, then the best rated.

All Kylas CRM alternatives →
  • Salesforce
    Salesforce CRM MCP server: accounts, contacts, opportunities, leads, tasks, and custom objects
    A
  • Follow Up Boss
    Follow Up Boss CRM in plain English. 160 tools; bring your own API key.
    A
  • Gambot WhatsApp Business API
    Send WhatsApp messages & templates and manage CRM, leads & campaigns via the Gambot WhatsApp API.
    B
  • Agency Handy
    Agency CRM, projects, tasks, invoices and proposals. Sign in with Agency Handy or use an API key.
    A
  • Apideck
    Apideck Unified API MCP — 330 tools across 200+ SaaS connectors (accounting, CRM, HRIS, ATS).
    A

More from kylastech →