Skip to main content
Glama
Mirlo MCP Server

Mirlo MCP Server

Official
by MirloLLC

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

  1. Ingresá a app.mirlo.com

  2. Andá a Mi Organización → API Keys

  3. Hacé click en + Crear API Key

  4. 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 --version

Debería mostrar algo como v22.x.x.

Paso 3: Configurá Claude Desktop

  1. Abrí Claude Desktop

  2. Andá a Settings (Configuración) → Developer → Edit Config

  3. Se abre un archivo. Reemplazá el contenido con:

{
  "mcpServers": {
    "mirlo": {
      "command": "npx",
      "args": ["-y", "@mirlo/mcp", "--api-key=TU_API_KEY_AQUI"]
    }
  }
}
  1. Reemplazá TU_API_KEY_AQUI con tu API key de Mirlo (la que copiaste en el Paso 1)

  2. 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"


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_xxx

Variables 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 tools
mirlo_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

    B3.2/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      18
      27
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to manage social media accounts and CRM operations, including posting, analytics, inbox management, and customer management.
      22
      Apache 2.0