namakan-mcp-crm
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=alexdemo 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 |
| MCP stdio (delimitación por Content-Length) |
| Enumera las herramientas unificadas |
| Invoca una herramienta sin un host MCP |
| Búsquedas simuladas + el error de escrituras desactivadas |
Herramientas
Herramienta | Lectura/escritura | Argumentos |
| lectura |
|
| lectura |
|
| lectura |
|
| lectura |
|
| escritura |
|
| escritura |
|
Backends
| Qué obtienes |
| Contactos/negocios sintéticos incluidos. |
|
|
| 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=TestLa 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
API-first CRM for LLMs - contacts, companies, deals and activities over a native MCP server.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
CRM + visual automation builder AI agents can drive via MCP: contacts, tags, maps, email/SMS flows.
Unified MCP Server is a remote MCP connector for AI agents and vertical AI products that provides access to 22,000+ authorized SaaS tools across 400+ integrations and 24 categories directly inside LLMs (Claude, GPT, Gemini, Cohere). Tools operate only on explicitly authorized customer connections, enabling agents to safely read and write against live third-party systems.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to interact with Bitrix24 CRM through standardized MCP tools, including searching and managing contacts, deals, leads, tasks, and replying in chats.MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP-native CRM backend for AI agents, enabling customer, opportunity, note, follow-up, and pipeline health management through 15 MCP tools.-
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables 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.1MIT