LinkedIn API MCP

linkedin-api-mcp

Aviso: Este es un proyecto independiente, de la comunidad. No está afiliado, autorizado, respaldado ni patrocinado por LinkedIn Corporation ni Microsoft. "LinkedIn" es una marca registrada de LinkedIn Corporation y se usa aquí únicamente con fines descriptivos para identificar el servicio de terceros con el que este software interactúa.

Un servidor MCP para LinkedIn. Maneja un navegador headless real (patchright, una bifurcación no detectada de Playwright) usando tu propia cookie de sesión de LinkedIn con la sesión iniciada. No hay API de scraping, ni relleno de credenciales, ni evasión del inicio de sesión de LinkedIn. Tu agente tiene 12 herramientas de lectura (perfiles, empresas, empleos, publicaciones, tu bandeja de entrada) y dos herramientas de escritura, mantenidas deliberadamente separadas: enviar un mensaje y enviar una solicitud de conexión. Cada acción pasa por una única sesión de navegador, una a la vez, con un ritmo limitado por controles que tú defines. Consulta Seguridad más abajo.

Documentación: mcp.johannsenlum.com/linkedin

Instalación (un clic)

Existen deeplinks solo para Cursor y VS Code; ningún otro cliente tiene un formato de enlace de instalación documentado. Estos rellenan previamente el comando de abajo; no hay nada más que rellenar, ya que la cookie vive en el llavero de tu sistema operativo, no en una variable de entorno.

Todos los clientes

claude mcp add linkedin -- uvx linkedin-api-mcp

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "servers": {
    "linkedin": {
      "type": "stdio",
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

[mcp_servers.linkedin]
command = "uvx"
args = ["linkedin-api-mcp"]

{
  "context_servers": {
    "linkedin": {
      "source": "custom",
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"]
    }
  }
}

Si prefieres no depender del llavero en un cliente concreto (un entorno sandboxed o CI), pasa la cookie directamente en lugar de ejecutar auth:

{
  "mcpServers": {
    "linkedin": {
      "command": "uvx",
      "args": ["linkedin-api-mcp"],
      "env": { "LINKEDIN_COOKIE": "your-li_at-value" }
    }
  }
}

Si haces esto en cualquier lugar, trata ese archivo de configuración con el mismo cuidado que la propia cookie: no lo subas a un repositorio y restringe sus permisos.

Cómo obtener tu cookie de sesión

LinkedIn no ofrece una clave API para este tipo de acceso, así que el servidor usa la misma cookie de sesión que tu navegador ya tiene.

1. Una sola vez: instala la compilación de Chromium que el servidor maneja.

   uvx --from linkedin-api-mcp patchright install chromium
   

2. Inicia sesión en linkedin.com en un navegador normal.
3. Abre DevTools (F12 o Cmd+Opt+I) → Application → Cookies → https://www.linkedin.com.
4. Busca la fila llamada li_at y copia su Value.

[!WARNING] Esta cookie es tu inicio de sesión de LinkedIn. Cualquiera que la tenga puede actuar como tú: leer tus mensajes, escribir a tus contactos, ver todo lo que tu cuenta puede ver, sin necesidad de tu contraseña. Sobrevive a un cambio de contraseña y no puede revocarse desde ninguna lista de sesiones que LinkedIn te muestre. Nunca la pegues en un chat, un commit, un issue, una captura de pantalla ni en ningún otro lugar que no sea linkedin-api-mcp auth.

5. Guárdala:

   uvx linkedin-api-mcp auth
   

   Pega el valor cuando se te solicite; la terminal no lo mostrará de vuelta. Por defecto se guarda en el llavero de tu sistema operativo (Keychain, Windows Credential Manager o Secret Service en Linux), nunca se escribe en un archivo de configuración.
6. Verifica que LinkedIn la acepta antes de conectar un cliente:

   uvx linkedin-api-mcp --test
   

   Imprime la configuración redactada del servidor y confirma que la sesión está activa. Nunca imprime la cookie en sí.

Herramientas

14 herramientas: 12 de lectura, 2 de escritura. send_message y connect son las únicas dos que cambian algo, y ambas son visibles para otra persona real en el momento en que se ejecutan: no hay paso de borrador, vista previa ni deshacer. Todo lo demás solo lee lo que tu cuenta ya puede ver. Cubierto por 68 pruebas.

Qué está verificado y qué no

Este es un proyecto de pocos días. En lugar de afirmar que todo funciona, esto es lo que realmente se ha comprobado con una cuenta real, y lo que no.

Seguridad

• Una cola de acciones serializada. Cada llamada de herramienta, incluida linkedin_status, pasa por la misma cola antes de tocar el navegador: una acción a la vez, nunca en paralelo.

• Un intervalo mínimo y un límite por hora, ambos aplicados, no solo declarados:

  Ajuste	Valor por defecto	Variable de entorno	Efecto
  Intervalo mínimo entre acciones	2 segundos	LINKEDIN_MIN_INTERVAL	Las llamadas se espacian respecto a la anterior, no se ejecutan una tras otra.
  Acciones por hora móvil	120	LINKEDIN_MAX_PER_HOUR	Una vez alcanzado, las llamadas posteriores fallan inmediatamente con un error rate_limited en lugar de ponerse en cola o esperar.

  El límite es local a este servidor: existe para evitar que un agente en bucle genere una ráfaga de tráfico de LinkedIn, no porque LinkedIn nos haya dado estos números. Bajarlos siempre es seguro; subirlos significa que decides que estás dispuesto a aceptar más riesgo del que los valores por defecto asumen.

• Bloqueo contra inyección de prompts en todo texto libre extraído. Cualquier cosa leída de una página de LinkedIn (un titular, una sección acerca de, un mensaje) pasa por tu agente como datos. Está delimitado antes de que tu agente lo vea, de modo que el texto en un perfil o en un mensaje no puede hacerse pasar por una instrucción.

• La cookie vive en el llavero de tu sistema operativo, no en un archivo de configuración, por defecto. Consulta Cómo obtener tu cookie de sesión.

• send_message demuestra la entrega antes de informar éxito. Sondea la conversación hasta que el texto enviado realmente aparece, y lanza send_unconfirmed en lugar de un falso {"sent": true} si no aparece.

Otras variables de entorno que el servidor lee: LINKEDIN_COOKIE (anula el llavero), LINKEDIN_HEADLESS (por defecto true), LINKEDIN_NAV_TIMEOUT_MS (por defecto 30000).

Preguntas frecuentes

¿Es seguro usar esto? ¿Me van a banear?

Esta herramienta controla una sesión de navegador real; no explota APIs no documentadas ni evita la autenticación. El Acuerdo de usuario de LinkedIn prohíbe el acceso automatizado, y las cuentas que usan herramientas automatizadas pueden ser restringidas o baneadas. Úsalo bajo tu propio riesgo; no hay garantía de seguridad de la cuenta. Si encuentras algún problema, házmelo saber en Discussions.

¿Qué pasa si mis agentes ejecutan demasiadas acciones?

Las llamadas de herramientas se ejecutan secuencialmente a través de una cola. Tú eres responsable del volumen de automatización que ejecutas; úsalo con moderación y da instrucciones a tus agentes de forma responsable.

Licencia

MIT © 2026 Johannsen Lum.

Úsalo, cámbialo, redistribúyelo, construye algo comercial sobre él: la única condición es que mantengas el aviso de copyright y el texto de la licencia. Viene sin ningún tipo de garantía.

Las contribuciones se aceptan bajo la misma licencia.

Contribuciones

Los issues y las pull requests son bienvenidos: github.com/JohannsenLum/linkedin-api-mcp. Los cambios se registran en CHANGELOG.md.

Ejecutar las pruebas

Instala las dependencias de desarrollo y ejecuta pytest desde la raíz del repositorio:

pip install -e ".[dev]"
python -m pytest -q

La suite de pruebas predeterminada no necesita Chromium, una cuenta de LinkedIn, LINKEDIN_COOKIE, ni acceso a la red. Las interacciones con el navegador se reemplazan por los dobles de prueba en tests/fakes.py, que analizan HTML predefinido y exponen la pequeña superficie de Playwright utilizada por las herramientas. Para un ejemplo de prueba de análisis, consulta tests/test_people_parsing.py.

Este es un proyecto independiente, no afiliado a LinkedIn Corporation. Consulta el aviso legal al inicio de este documento.