Mirlo MCP Server
OfficialMirlo MCP Server connects you to Mirlo CRM, enabling natural language management of deals, contacts, accounts, tickets, tasks, messaging, and voice calls across 21 tools.
Deals/Opportunities
List deals with filters (status, amount, pipeline, stage, owner, time in stage)
Get full deal details including stage history, contacts, and conversations
Create, update, and move deals between pipeline stages
List all pipelines and their stages
Contacts & Accounts
List and search contacts by name, email, or phone; filter by owner or account
Get a specific contact by ID
Create new contacts with name, email, phone, and linked account
List accounts/companies filtered by name, domain, industry, or lifecycle stage
Create new accounts with company details
Tickets
List support tickets filtered by state, priority, owner, or excluding closed tickets
Create new support tickets with title, description, priority, and assignee
Tasks
List tasks filtered by type (call, email, meeting, follow-up, to-do), status, due date, priority, or associated CRM entity
Create tasks linked to deals, tickets, contacts, or accounts
Mark tasks as completed
Messaging
Send WhatsApp or SMS messages to a phone number
Send pre-approved WhatsApp template messages with custom parameters
List recent conversations across channels
Voice
List phone calls filtered by direction (inbound/outbound)
Retrieve AI-generated transcripts of specific phone calls
Allows sending WhatsApp messages (including templates) via Mirlo's messaging API, as well as listing conversations.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Mirlo MCP Server list my deals in the sales pipeline"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Mirlo para Claude
Conectá tu CRM de Mirlo con Claude para consultar y gestionar oportunidades, contactos, tickets y tareas usando lenguaje natural.
¿Qué puedo hacer?
Preguntale a Claude cosas como:
"¿Cuántos deals abiertos tengo arriba de $100k?"
"Creame un ticket de soporte con prioridad alta"
"¿Qué tareas tengo vencidas?"
"Dame los contactos de la empresa Farmacias del Ahorro"
"¿Cuáles oportunidades cierran esta semana?"
"Creá una tarea para llamar al cliente mañana"
Related MCP server: Bellink MCP Server
Configuración paso a paso
Paso 1: Obtené tu API Key de Mirlo
Ingresá a app.mirlo.com
Andá a Mi Organización → API Keys
Hacé click en + Crear API Key
Copiá la key (empieza con
sk_live_)
Paso 2: Instalá Node.js (si no lo tenés)
Descargá e instalá Node.js desde nodejs.org. Elegí la versión LTS (recomendada).
Para verificar que está instalado, abrí la Terminal y escribí:
node --versionDebería mostrar algo como v22.x.x.
Paso 3: Configurá Claude Desktop
Abrí Claude Desktop
Andá a Settings (Configuración) → Developer → Edit Config
Se abre un archivo. Reemplazá el contenido con:
{
"mcpServers": {
"mirlo": {
"command": "npx",
"args": ["-y", "@mirlo/mcp", "--api-key=TU_API_KEY_AQUI"]
}
}
}Reemplazá
TU_API_KEY_AQUIcon tu API key de Mirlo (la que copiaste en el Paso 1)Guardá el archivo y reiniciá Claude Desktop
Paso 4: ¡Listo!
Abrí una nueva conversación en Claude y preguntá algo sobre tu CRM:
"¿Cuántos tickets abiertos tengo?"
Claude va a usar las herramientas de Mirlo automáticamente para responder.
Configuración con Claude Code (CLI)
Si usás Claude Code en la terminal:
# Agregar el MCP server
claude mcp add mirlo npx -y @mirlo/mcp --api-key=sk_live_xxx¿Qué puede hacer?
CRM — Oportunidades
Acción | Ejemplo |
Listar deals | "Dame las oportunidades abiertas ordenadas por monto" |
Buscar deals | "¿Hay deals que cierran esta semana?" |
Crear deal | "Creá una oportunidad para Acme Corp por $50,000" |
Mover de etapa | "Mové el deal de Acme a Negociación" |
Filtrar por tiempo | "¿Qué deals llevan más de 24 horas en Prospecto?" |
CRM — Contactos y Cuentas
Acción | Ejemplo |
Buscar contactos | "Buscame los contactos de la empresa Café Digital" |
Crear contacto | "Creá un contacto: Ana García, ana@empresa.com" |
Listar cuentas | "¿Qué cuentas tenemos en la industria Tecnología?" |
CRM — Tickets
Acción | Ejemplo |
Ver tickets abiertos | "¿Cuántos tickets abiertos hay?" |
Crear ticket | "Creá un ticket urgente: Error en la integración" |
Filtrar por prioridad | "Mostrá los tickets de prioridad alta" |
CRM — Tareas
Acción | Ejemplo |
Ver tareas pendientes | "¿Qué tareas tengo para hoy?" |
Tareas vencidas | "¿Hay tareas vencidas?" |
Crear tarea | "Creá una tarea para llamar a Ana García mañana" |
Completar tarea | "Marcá como completada la tarea de llamar a Ana" |
Messaging
Acción | Ejemplo |
Enviar mensaje | "Mandá un WhatsApp a +52 55 1234 5678 diciendo: Hola, te contacto de Mirlo" |
Ver conversaciones | "Mostrá las últimas conversaciones" |
Voz
Acción | Ejemplo |
Ver llamadas | "¿Cuántas llamadas entrantes hubo hoy?" |
Transcripción | "Dame la transcripción de la última llamada" |
Solución de problemas
"Claude no encuentra las herramientas de Mirlo"
Verificá que reiniciaste Claude Desktop después de editar la configuración
Verificá que tu API Key es válida en app.mirlo.com → API Keys
"Error de autenticación"
Tu API Key puede haber expirado. Generá una nueva en Mi Organización → API Keys
"npx no se encuentra"
Instalá Node.js desde nodejs.org
Soporte
¿Necesitás ayuda? Contactanos en mirlo.com o por WhatsApp.
Para desarrolladores
Instalación manual
npm install -g @mirlo/mcp
mirlo-mcp --api-key=sk_live_xxxVariables de entorno
MIRLO_API_KEY=sk_live_xxx # API key (requerida)
MIRLO_BASE_URL=https://... # URL base (opcional, default: api.mirlo.com)Herramientas disponibles (21 tools)
CRM: mirlo_list_deals, mirlo_get_deal, mirlo_create_deal, mirlo_update_deal, mirlo_move_deal_stage, mirlo_list_contacts, mirlo_get_contact, mirlo_create_contact, mirlo_list_accounts, mirlo_create_account, mirlo_list_tickets, mirlo_create_ticket, mirlo_list_tasks, mirlo_create_task, mirlo_complete_task, mirlo_list_pipelines
Messaging: mirlo_send_message, mirlo_send_template, mirlo_list_conversations
Voice: mirlo_list_calls, mirlo_get_call_transcript
Licencia
MIT
Available Tools
21 toolsmirlo_complete_taskB
Mark a task as completed.
Inputs: task_id (required).
mirlo_create_accountC
Create a new account/company.
Inputs: name (required), city, email, phone, +3 more.
mirlo_create_contactB
Create a new contact.
Inputs: full_name (required), last_name, account_id, first_name, +2 more.
mirlo_create_dealB
Create a new deal/opportunity in a pipeline.
Inputs: name (required), stage_id (required), pipeline_id (required), amount, +4 more.
mirlo_create_taskC
Create a task, optionally associated to a deal, ticket, contact, or account.
Inputs: title (required), type, notes, deal_id, +5 more.
mirlo_create_ticketB
Create a support ticket.
Inputs: title (required), owner_id, priority, body_html.
mirlo_get_call_transcriptA
Get the AI-generated transcript of a phone call.
Inputs: call_id (required).
mirlo_get_contactA
Get a contact by ID.
Inputs: contact_id (required).
mirlo_get_dealA
Get a deal by ID with full details including stage times, contacts, and conversations.
Inputs: deal_id (required).
mirlo_list_accountsC
List accounts/companies with optional filters.
Inputs: limit, offset, search, industry, +1 more.
mirlo_list_callsC
List phone calls with filters.
Inputs: limit, direction.
mirlo_list_contactsC
List contacts with optional search and filters.
Inputs: limit, offset, search, owner_id, +1 more.
mirlo_list_conversationsC
List recent conversations across channels.
Inputs: limit, status.
mirlo_list_dealsA
List deals/opportunities with optional filters. Returns paginated results with total count.
Inputs: limit, offset, search, status, +7 more.
mirlo_list_pipelinesA
List all pipelines with their stages. Useful for getting pipeline/stage IDs before creating deals.
Inputs: no named parameters.
mirlo_list_tasksA
List tasks with filters. Supports filtering by assignee, status, due date, and associated entities.
Inputs: type, limit, deal_id, overdue, +4 more.
mirlo_list_ticketsC
List support tickets with filters.
Inputs: limit, state, offset, search, +3 more.
mirlo_move_deal_stageB
Move a deal to a different pipeline stage.
Inputs: deal_id (required), stage_id (required).
mirlo_send_messageC
Send a WhatsApp or SMS message to a phone number.
Inputs: to (required), body (required), channel.
mirlo_send_templateC
Send a pre-approved WhatsApp template message.
Inputs: to (required), template_id (required), params.
mirlo_update_dealC
Update an existing deal. Only provided fields are updated.
Inputs: deal_id (required), name, amount, status, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a distinct action on a specific entity (e.g., create contact vs. list contacts, send message vs. send template). No two tools have overlapping purposes, and descriptions clearly differentiate them.
All tools follow a consistent 'mirlo_verb_noun' pattern with snake_case (e.g., mirlo_create_contact, mirlo_list_deals). No mixing of conventions or styles.
21 tools is slightly above the typical 3-15 range, but the CRM/communications domain covers many entities (accounts, contacts, deals, tasks, tickets, calls, messages), so the count is reasonable and each tool earns its place.
The tool set covers core CRUD for deals and tasks, but lacks update for contacts, accounts, and tickets, and lacks delete operations entirely. These gaps may cause agent failures in workflows that require full lifecycle management.
Related MCP Connectors
Connect assistants to your workspace knowledge, skills, and work tools.
Connect your AI assistant to Revensi OS agents, workflows, and business data.
Connect AI assistants to Appimate's Business Agent Tools and Services.
Connect AI assistants to Stellary projects, boards, documents, and governed agent workflows.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without the risk of account bans.1827MIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to over 30 business tools like Gmail, Slack, and Airtable through a single unified interface. It enables users to perform actions across multiple platforms using natural language without managing individual API integrations.22 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to your Brivvy workspace so they can use your brand voices, templates, and glossary for on-brand content.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage social media accounts and CRM operations, including posting, analytics, inbox management, and customer management.22Apache 2.0