Skip to main content
Glama
namakan-mcp-crm

namakan-mcp-crm

by cfollette18

namakan-mcp-crm

Un único servidor MCP para cualquier CRM. Los agentes llaman a crm_find_contact / crm_list_deals — nunca llegan a saber si la plataforma funciona con HubSpot, Salesforce, Dynamics, Pipedrive o Zoho.

Incluye un CRM simulado para que funcione antes de que nadie te dé una clave de API. Las escrituras están desactivadas hasta que establezcas una variable de entorno.

Ejecución en 60 segundos

pip install git+https://github.com/cfollette18/namakan-mcp-crm.git
namakan-mcp-crm demo
namakan-mcp-crm tools
namakan-mcp-crm call crm_find_contact query=alex

demo imprime tres bloques JSON: una búsqueda de contacto, una lista de negocios y una escritura fallida (solo lectura por defecto). La última es intencionada.

Related MCP server: ai-crm-engine

Cómo encaja

flowchart LR
  Agent[Hermes / Cursor / Claude Desktop] -->|MCP stdio| Server[namakan-mcp-crm]
  Server --> Tools[crm_find_contact etc.]
  Tools --> Mock[mock backend]
  Tools --> Rest[generic REST]
  Tools --> Vendor[HubSpot / Salesforce / ... adapter]

Cambia el backend mediante NAMAKAN_CRM_BACKEND. Los nombres de las herramientas no cambian.

Conéctalo a Cursor

Crea o edita .cursor/mcp.json (proyecto) o ~/.cursor/mcp.json:

{
  "mcpServers": {
    "namakan-crm": {
      "command": "namakan-mcp-crm",
      "args": ["serve"],
      "env": {
        "NAMAKAN_CRM_BACKEND": "mock"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json) y la configuración MCP de Hermes usan la misma estructura de command / env. Los hosts que no pasan argumentos también funcionan: namakan-mcp-crm sin subcomando es serve.

CLI

Comando

Qué hace

namakan-mcp-crm / serve

MCP stdio (delimitación por Content-Length)

namakan-mcp-crm tools

Enumera las herramientas unificadas

namakan-mcp-crm call TOOL key=value

Invoca una herramienta sin un host MCP

namakan-mcp-crm demo

Búsquedas simuladas + el error de escrituras desactivadas

Herramientas

Herramienta

Lectura/escritura

Argumentos

crm_find_contact

lectura

query

crm_find_account

lectura

query

crm_list_deals

lectura

account_id?

crm_get_deal

lectura

deal_id

crm_create_deal

escritura

name, account_id?, amount?, stage?

crm_log_activity

escritura

note, contact_id?, deal_id?

Backends

NAMAKAN_CRM_BACKEND

Qué obtienes

mock (por defecto)

Contactos/negocios sintéticos incluidos. NAMAKAN_CRM_STORE=/tmp/crm.json opcional para persistir las escrituras

rest

NAMAKAN_CRM_BASE_URL + NAMAKAN_CRM_TOKEN opcional. Espera JSON de GET /contacts?query=

hubspot salesforce dynamics pipedrive zoho

Stub hasta que existan credenciales en el tenant del cliente. No pongas tokens en este repositorio

Escrituras

NAMAKAN_MCP_ALLOW_WRITES=1 NAMAKAN_MCP_DRY_RUN=1 namakan-mcp-crm call crm_create_deal name=Test

La ejecución en seco devuelve { "dry_run": true, "would_call": ... } y no toca el almacén. Las escrituras en producción necesitan esa variable de entorno y una vía de aprobación humana (Namakan: ciso).

Python

from namakan_mcp_crm import handle
from namakan_mcp_crm.backends import MockCrm

print(handle("crm_find_contact", {"query": "alex"}, backend=MockCrm()))

Licencia

MIT. Copyright (c) 2026 Namakan AI Engineering.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to interact with Bitrix24 CRM through standardized MCP tools, including searching and managing contacts, deals, leads, tasks, and replying in chats.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP-native CRM backend for AI agents, enabling customer, opportunity, note, follow-up, and pipeline health management through 15 MCP tools.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to read and write CRM data—companies, contacts, opportunities, tasks, and interactions—through MCP, with OAuth and provenance tracking for every value.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to perform go-to-market workflows such as company and contact enrichment, CRM querying, and controlled, audited writes to a CRM through MCP tools callable from any MCP client.
      1
      MIT