mcp-server-unipile

Servidor MCP de 95 ferramentas para a API unificada Unipile — mensagens (LinkedIn, WhatsApp, Instagram, Telegram), e-mail (Gmail, Outlook), calendário, pesquisa no LinkedIn (pessoas, empresas, publicações, vagas), gerenciamento de perfil, conexões, InMail e webhooks.

GitHub

Experimente este MCPPatrocinado

Documentação

mcp-server-unipile

Um servidor abrangente de Model Context Protocol (MCP) para a API Unipile — 95 ferramentas cobrindo toda a superfície da API.

Conecte seu assistente de IA ao LinkedIn, E-mail, Calendário, WhatsApp, Instagram e Telegram através de uma interface unificada.

Recursos

Categoria	Ferramentas	Capacidades
Gerenciamento de Contas	10	Listar, obter, conectar, excluir, reconectar, ressincronizar, reiniciar contas + checkpoints de 2FA
Mensagens	14	Chat multiplataforma (LinkedIn, WhatsApp, Instagram, Telegram) com busca, reações, encaminhamento
Participantes	6	Gerenciamento de contatos, fotos de perfil, histórico de chat por pessoa
E-mail	11	Enviar, ler, buscar, rascunho, rastrear aberturas/cliques (Gmail + Outlook unificados)
Calendário	7	Eventos, agendamento, consultas de disponibilidade (Google + Microsoft unificados)
Busca no LinkedIn	6	Pessoas, empresas, publicações, vagas (lado do candidato), Sales Navigator
Perfis do LinkedIn	7	Visualizar/editar perfis, seguidores, seguindo, atividade do usuário
Conexões do LinkedIn	7	Convites, relações, gerenciamento de conexões
InMail do LinkedIn	2	Enviar InMail, verificar créditos
Publicações do LinkedIn	6	Criar, comentar, reagir, visualizar engajamento
Vagas do LinkedIn	13	Busca de vagas, publicação, gerenciamento de candidatos, recursos de recrutador
Webhooks	3	Notificações de eventos em tempo real
Avançado	3	Visitantes de perfil, acesso bruto à API, recomendações de habilidades

Instalação

Usando uvx (recomendado)

uvx mcp-server-unipile

Usando pip

pip install mcp-server-unipile

A partir do código-fonte

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

Configuração

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`UNIPILE_BASE_URL`	Sim	URL base da sua API Unipile (ex.: `https://apiX.unipile.com:XXXXX/api/v1`)
`UNIPILE_API_KEY`	Sim	Sua chave de API Unipile
`UNIPILE_LINKEDIN_ACCOUNT_ID`	Não	ID de conta padrão do LinkedIn (evita passá-lo para cada ferramenta do LinkedIn)
`UNIPILE_EMAIL_ACCOUNT_ID`	Não	ID de conta de e-mail padrão (evita passá-lo para cada ferramenta de e-mail/calendário)

Obtenha suas credenciais de API no Painel Unipile.

Claude Desktop

Adicione ao seu 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

Adicione ao seu .claude.json (escopo de usuário ou projeto):

{
  "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

Adicione ao seu .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"
      }
    }
  }
}

Pré-requisitos

Uma conta Unipile com acesso à API
Pelo menos uma conta conectada (LinkedIn, Gmail, WhatsApp, etc.) no seu painel Unipile
Python 3.10+

Exemplos de Uso

Buscar vagas

Search for remote Python developer jobs posted this week

Seu assistente de IA chamará search_jobs com filtros de palavras-chave, remote_policy e posted_at.

Enviar uma mensagem no LinkedIn

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

Usa search_people para encontrar John, depois send_message para entrar em contato.

Gerenciar e-mail

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

Usa list_emails com filtros, depois draft_email para a resposta.

Rastrear engajamento

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

Usa get_profile_visitors e list_followers.

Todas as 95 Ferramentas

Gerenciamento de Contas (10)

list_accounts - Listar todas as contas conectadas
get_account - Obter detalhes de uma única conta
connect_account - Conectar via autenticação nativa (usuário/senha)
reconnect_account - Reconectar via autenticação hospedada (retorna URL do navegador)
delete_account - Remover uma conta
resync_account - Forçar ressincronização completa de dados
restart_account - Reiniciar processos de sincronização
solve_checkpoint - Resolver desafio de 2FA/checkpoint
resend_checkpoint - Reenviar código de verificação
get_my_profile - Obter seu próprio perfil

Mensagens (14)

list_chats - Listar conversas (filtráveis por conta/plataforma)
get_chat - Obter detalhes da conversa
get_chat_messages - Listar mensagens em um chat
get_message - Obter detalhes de uma única mensagem
send_message - Enviar uma mensagem em um chat
forward_message - Encaminhar uma mensagem
get_message_attachment - Baixar anexo
start_chat - Iniciar nova conversa
update_chat - Marcar como lida/não lida, arquivar
sync_chat - Sincronizar histórico da conversa
list_all_messages - Busca de mensagens entre chats
delete_chat - Excluir uma conversa
delete_message - Excluir uma mensagem
list_chat_attendees - Listar participantes em um chat

Participantes (6)

list_attendees - Listar todos os contatos/participantes
get_attendee - Obter detalhes do participante
get_attendee_picture - Baixar foto de perfil (base64)
list_chats_by_attendee - Encontrar chats com uma pessoa específica
list_messages_by_attendee - Mensagens de uma pessoa específica
add_message_reaction - Reagir a uma mensagem

E-mail (11)

list_emails - Listar e-mails com filtros
get_email - Ler um e-mail específico
send_email - Enviar e-mail com rastreamento opcional de abertura/clique
draft_email - Criar rascunho de e-mail
delete_email - Excluir e-mail
get_email_attachment - Baixar anexo de e-mail
list_email_contacts - Listar contatos de e-mail
update_email - Modificar e-mail (ler/estrelar/mover)
list_email_folders - Listar pastas (caixa de entrada, enviados, rascunhos, etc.)
get_email_folder - Obter detalhes da pasta
list_email_labels - Listar rótulos do Gmail

Calendário (7)

list_calendars - Listar todos os calendários
get_calendar - Obter detalhes do calendário
list_events - Listar eventos do calendário
get_event - Obter detalhes do evento
create_event - Criar evento de calendário
edit_event - Modificar evento
delete_event - Excluir evento

Busca no LinkedIn (6)

search_people - Buscar membros do LinkedIn
search_people_sales_nav - Busca avançada no Sales Navigator
search_companies - Buscar empresas
search_posts - Buscar conteúdo do LinkedIn
search_jobs - Buscar vagas de emprego (lado do candidato, com sinalizador Easy Apply)
get_search_params - Obter IDs de filtros válidos (localizações, setores, etc.)

Perfis e Usuários do LinkedIn (7)

get_profile - Obter o perfil do LinkedIn de um usuário
get_company_profile - Obter detalhes da página da empresa
edit_own_profile - Editar seu título/resumo/localização
list_followers - Listar seus seguidores
list_following - Listar quem você segue
list_user_comments - Histórico de comentários do usuário
list_user_reactions - Histórico de reações do usuário

Conexões do LinkedIn (7)

send_invitation - Enviar solicitação de conexão
accept_invitation - Aceitar solicitação de conexão
decline_invitation - Recusar solicitação
cancel_invitation - Cancelar solicitação enviada
list_invitations_sent - Visualizar convites enviados
list_invitations_received - Visualizar convites recebidos
list_relations - Listar todas as conexões

InMail do LinkedIn (2)

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

Publicações do LinkedIn (6)

create_post - Criar publicação no LinkedIn
get_post - Obter detalhes da publicação
comment_on_post - Comentar em uma publicação
react_to_post - Reagir a uma publicação
list_post_comments - Listar comentários da publicação
list_post_reactions - Listar reações da publicação

Vagas e Recrutador do LinkedIn (13)

search_jobs - Buscar vagas como candidato
list_jobs - Listar suas vagas publicadas
get_job - Obter detalhes da vaga
create_job - Criar vaga
edit_job - Editar vaga
publish_job - Publicar vaga em rascunho
close_job - Fechar vaga
get_job_applicants - Listar candidatos
get_job_applicant - Obter detalhes do candidato
get_applicant_resume - Baixar currículo do candidato
get_hiring_projects - Listar projetos de contratação do Recruiter
get_hiring_project - Obter detalhes do projeto
perform_linkedin_action - Seguir/deixar de seguir/bloquear usuários
solve_job_checkpoint - Resolver checkpoint de publicação de vaga

Webhooks (3)

list_webhooks - Listar webhooks configurados
create_webhook - Criar webhook
delete_webhook - Excluir webhook

Avançado (3)

get_profile_visitors - Quem visualizou seu perfil
endorse_skill - Recomendar uma habilidade de uma conexão
raw_linkedin_request - Solicitação bruta à API do LinkedIn
list_user_posts - Listar publicações de um usuário

Como Funciona

Este servidor encapsula a API REST Unipile em ferramentas MCP. A Unipile atua como uma camada unificada sobre múltiplas plataformas:

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

Cada ferramenta mapeia para um endpoint da API Unipile. A autenticação é feita via chave de API. Operações específicas de conta usam os IDs de conta padrão das variáveis de ambiente ou aceitam parâmetros explícitos de account_id.

Licença

MIT