mcp-server-unipile

Servidor MCP de 95 herramientas para la API unificada de Unipile: mensajería (LinkedIn, WhatsApp, Instagram, Telegram), correo electrónico (Gmail, Outlook), calendario, búsqueda en LinkedIn (personas, empresas, publicaciones, empleos), gestión de perfiles, conexiones, InMail y webhooks.

GitHub

Prueba este MCPPatrocinado

Documentación

mcp-server-unipile

Un servidor integral del Model Context Protocol (MCP) para la API de Unipile — 95 herramientas que cubren toda la superficie de la API.

Conecta tu asistente de IA a LinkedIn, Email, Calendario, WhatsApp, Instagram y Telegram a través de una única interfaz unificada.

Características

Categoría	Herramientas	Capacidades
Gestión de cuentas	10	Listar, obtener, conectar, eliminar, reconectar, resincronizar, reiniciar cuentas + puntos de control 2FA
Mensajería	14	Chat multiplataforma (LinkedIn, WhatsApp, Instagram, Telegram) con búsqueda, reacciones, reenvío
Asistentes	6	Gestión de contactos, fotos de perfil, historial de chat por persona
Email	11	Enviar, leer, buscar, borrador, seguimiento de aperturas/clics (Gmail + Outlook unificados)
Calendario	7	Eventos, programación, consultas de disponibilidad (Google + Microsoft unificados)
Búsqueda en LinkedIn	6	Personas, empresas, publicaciones, empleos (lado candidato), Sales Navigator
Perfiles de LinkedIn	7	Ver/editar perfiles, seguidores, siguiendo, actividad del usuario
Conexiones de LinkedIn	7	Invitaciones, relaciones, gestión de conexiones
InMail de LinkedIn	2	Enviar InMail, verificar créditos
Publicaciones de LinkedIn	6	Crear, comentar, reaccionar, ver interacción
Empleos de LinkedIn	13	Búsqueda de empleo, publicación, gestión de solicitantes, funciones de reclutador
Webhooks	3	Notificaciones de eventos en tiempo real
Avanzado	3	Visitantes de perfil, acceso a API sin procesar, recomendaciones de habilidades

Instalación

Usando uvx (recomendado)

uvx mcp-server-unipile

Usando pip

pip install mcp-server-unipile

Desde el código fuente

git clone https://github.com/Sundeepg98/mcp-server-unipile.git
cd mcp-server-unipile
pip install -e .

Configuración

Variables de entorno

Variable	Requerida	Descripción
`UNIPILE_BASE_URL`	Sí	Tu URL base de la API de Unipile (p. ej., `https://apiX.unipile.com:XXXXX/api/v1`)
`UNIPILE_API_KEY`	Sí	Tu clave de API de Unipile
`UNIPILE_LINKEDIN_ACCOUNT_ID`	No	ID de cuenta de LinkedIn predeterminado (evita pasarlo a cada herramienta de LinkedIn)
`UNIPILE_EMAIL_ACCOUNT_ID`	No	ID de cuenta de email predeterminado (evita pasarlo a cada herramienta de email/calendario)

Obtén tus credenciales de API desde el Panel de Unipile.

Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "unipile": {
      "command": "uvx",
      "args": ["mcp-server-unipile"],
      "env": {
        "UNIPILE_BASE_URL": "https://apiX.unipile.com:XXXXX/api/v1",
        "UNIPILE_API_KEY": "your_api_key",
        "UNIPILE_LINKEDIN_ACCOUNT_ID": "your_linkedin_id",
        "UNIPILE_EMAIL_ACCOUNT_ID": "your_email_id"
      }
    }
  }
}

Claude Code

Agrega a tu .claude.json (ámbito de usuario o proyecto):

{
  "mcpServers": {
    "unipile": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-unipile"],
      "env": {
        "UNIPILE_BASE_URL": "https://apiX.unipile.com:XXXXX/api/v1",
        "UNIPILE_API_KEY": "your_api_key",
        "UNIPILE_LINKEDIN_ACCOUNT_ID": "your_linkedin_id",
        "UNIPILE_EMAIL_ACCOUNT_ID": "your_email_id"
      }
    }
  }
}

VS Code / Cursor

Agrega a tu .vscode/mcp.json:

{
  "servers": {
    "unipile": {
      "command": "uvx",
      "args": ["mcp-server-unipile"],
      "env": {
        "UNIPILE_BASE_URL": "https://apiX.unipile.com:XXXXX/api/v1",
        "UNIPILE_API_KEY": "your_api_key"
      }
    }
  }
}

Requisitos previos

Una cuenta de Unipile con acceso a la API
Al menos una cuenta conectada (LinkedIn, Gmail, WhatsApp, etc.) en tu panel de Unipile
Python 3.10+

Ejemplos de uso

Buscar empleos

Search for remote Python developer jobs posted this week

Tu asistente de IA llamará a search_jobs con filtros de palabras clave, remote_policy y posted_at.

Enviar un mensaje de LinkedIn

Message John Smith on LinkedIn asking about the engineering role at his company

Usa search_people para encontrar a Juan, luego send_message para contactarlo.

Gestionar email

Show me unread emails from today and draft a reply to the one from HR

Usa list_emails con filtros, luego draft_email para la respuesta.

Seguimiento de interacción

Who viewed my LinkedIn profile this week? Also show my latest followers.

Usa get_profile_visitors y list_followers.

Las 95 herramientas

Gestión de cuentas (10)

list_accounts - Listar todas las cuentas conectadas
get_account - Obtener detalles de una cuenta individual
connect_account - Conectar mediante autenticación nativa (usuario/contraseña)
reconnect_account - Reconectar mediante autenticación alojada (devuelve URL del navegador)
delete_account - Eliminar una cuenta
resync_account - Forzar resincronización completa de datos
restart_account - Reiniciar procesos de sincronización
solve_checkpoint - Resolver desafío 2FA/punto de control
resend_checkpoint - Reenviar código de verificación
get_my_profile - Obtener tu propio perfil

Mensajería (14)

list_chats - Listar conversaciones (filtrables por cuenta/plataforma)
get_chat - Obtener detalles de conversación
get_chat_messages - Listar mensajes en un chat
get_message - Obtener detalles de un mensaje individual
send_message - Enviar un mensaje en un chat
forward_message - Reenviar un mensaje
get_message_attachment - Descargar adjunto
start_chat - Iniciar nueva conversación
update_chat - Marcar como leído/no leído, archivar
sync_chat - Sincronizar historial de conversación
list_all_messages - Búsqueda de mensajes entre chats
delete_chat - Eliminar una conversación
delete_message - Eliminar un mensaje
list_chat_attendees - Listar participantes en un chat

Asistentes (6)

list_attendees - Listar todos los contactos/asistentes
get_attendee - Obtener detalles de asistente
get_attendee_picture - Descargar foto de perfil (base64)
list_chats_by_attendee - Encontrar chats con una persona específica
list_messages_by_attendee - Mensajes de una persona específica
add_message_reaction - Reaccionar a un mensaje

Email (11)

list_emails - Listar emails con filtros
get_email - Leer un email específico
send_email - Enviar email con seguimiento opcional de aperturas/clics
draft_email - Crear borrador de email
delete_email - Eliminar email
get_email_attachment - Descargar adjunto de email
list_email_contacts - Listar contactos de email
update_email - Modificar email (leer/destacar/mover)
list_email_folders - Listar carpetas (bandeja de entrada, enviados, borradores, etc.)
get_email_folder - Obtener detalles de carpeta
list_email_labels - Listar etiquetas de Gmail

Calendario (7)

list_calendars - Listar todos los calendarios
get_calendar - Obtener detalles de calendario
list_events - Listar eventos de calendario
get_event - Obtener detalles de evento
create_event - Crear evento de calendario
edit_event - Modificar evento
delete_event - Eliminar evento

Búsqueda en LinkedIn (6)

search_people - Buscar miembros de LinkedIn
search_people_sales_nav - Búsqueda avanzada de Sales Navigator
search_companies - Buscar empresas
search_posts - Buscar contenido de LinkedIn
search_jobs - Buscar ofertas de empleo (lado candidato, con indicador de Easy Apply)
get_search_params - Obtener IDs de filtros válidos (ubicaciones, industrias, etc.)

Perfiles y usuarios de LinkedIn (7)

get_profile - Obtener el perfil de LinkedIn de un usuario
get_company_profile - Obtener detalles de página de empresa
edit_own_profile - Editar tu titular/resumen/ubicación
list_followers - Listar tus seguidores
list_following - Listar a quién sigues
list_user_comments - Historial de comentarios del usuario
list_user_reactions - Historial de reacciones del usuario

Conexiones de LinkedIn (7)

send_invitation - Enviar solicitud de conexión
accept_invitation - Aceptar solicitud de conexión
decline_invitation - Rechazar solicitud
cancel_invitation - Cancelar solicitud enviada
list_invitations_sent - Ver invitaciones enviadas
list_invitations_received - Ver invitaciones recibidas
list_relations - Listar todas las conexiones

InMail de LinkedIn (2)

send_inmail - Enviar mensaje InMail
get_inmail_credits - Verificar créditos restantes

Publicaciones de LinkedIn (6)

create_post - Crear publicación de LinkedIn
get_post - Obtener detalles de publicación
comment_on_post - Comentar en una publicación
react_to_post - Reaccionar a una publicación
list_post_comments - Listar comentarios de publicación
list_post_reactions - Listar reacciones de publicación

Empleos y reclutador de LinkedIn (13)

search_jobs - Buscar ofertas de empleo como candidato
list_jobs - Listar tus ofertas de empleo
get_job - Obtener detalles de oferta de empleo
create_job - Crear oferta de empleo
edit_job - Editar oferta de empleo
publish_job - Publicar empleo en borrador
close_job - Cerrar oferta de empleo
get_job_applicants - Listar solicitantes
get_job_applicant - Obtener detalles de solicitante
get_applicant_resume - Descargar currículum del solicitante
get_hiring_projects - Listar proyectos de contratación de Recruiter
get_hiring_project - Obtener detalles de proyecto
perform_linkedin_action - Seguir/dejar de seguir/bloquear usuarios
solve_job_checkpoint - Resolver punto de control de publicación de empleo

Webhooks (3)

list_webhooks - Listar webhooks configurados
create_webhook - Crear webhook
delete_webhook - Eliminar webhook

Avanzado (3)

get_profile_visitors - Quién vio tu perfil
endorse_skill - Recomendar una habilidad de una conexión
raw_linkedin_request - Solicitud de API de LinkedIn sin procesar
list_user_posts - Listar publicaciones de un usuario

Cómo funciona

Este servidor envuelve la API REST de Unipile en herramientas MCP. Unipile actúa como una capa unificada sobre múltiples plataformas:

Your AI Assistant
      |
      v
  MCP Server (this package)
      |
      v
  Unipile API
      |
      v
  LinkedIn | Gmail | WhatsApp | Instagram | Telegram | Outlook

Cada herramienta se asigna a un endpoint de la API de Unipile. La autenticación se maneja mediante clave de API. Las operaciones específicas de cuenta usan los IDs de cuenta predeterminados de las variables de entorno o aceptan parámetros explícitos de account_id.

Licencia

MIT