How to connect your AI agent to LinkedIn

Short answer: Iridium is the easiest way to connect your agent to your LinkedIn. Connect LinkedIn to Iridium once, then add one URL to whichever agent you use. The URL is the same for every agent, so the second one takes a minute.

Step 1: connect LinkedIn to Iridium

Sign in at iridiumhqmcp.com/app with Google or GitHub. Signing in only identifies you; it does not touch LinkedIn. Then connect your LinkedIn account. There are two ways to do it, and both go through Unipile, the session broker Iridium runs on.

  • With your LinkedIn credentials. Click Connect LinkedIn and sign in on Unipile's hosted page. Two-factor prompts are handled there. Your password is entered on their page and is never stored by Iridium.
  • With your li_at session cookie. If you would rather not type a LinkedIn password anywhere, sign in to linkedin.com in your browser, open DevTools, then Application, then Cookies, then linkedin.com, and copy the value of li_at. Paste it into Iridium. This is the same cookie your browser already holds, so nothing new is created.

Either way, Iridium ends up holding an opaque account handle and nothing else. Disconnecting in Settings revokes the session at Unipile immediately.

Step 2: add Iridium to your agent

Every agent below gets the same address:

https://api.iridiumhqmcp.com/mcp

The first time an agent connects, it sends you to Iridium to sign in and click Allow. That is the whole authorization. There is no API key to paste and nothing to configure per client.

How do I connect Claude to LinkedIn?

  1. In Claude, open Settings, then Connectors.
  2. Click Add custom connector, paste the URL, and click Add.
  3. Claude sends you to Iridium. Sign in and click Allow.

The connector then works in the Claude web app, the desktop app, and Claude mobile. Claude connects to Iridium from Anthropic's cloud, not from your device, so it keeps working when your laptop is closed.

How do I connect Claude Code to LinkedIn?

  1. In your terminal: claude mcp add --transport http iridium https://api.iridiumhqmcp.com/mcp
  2. Inside a Claude Code session, type /mcp and sign in to Iridium when the browser opens.

The LinkedIn tools appear in that session and every later one. Ask it to find people, draft outreach, or read the activity log the same way you would in Claude.

How do I connect Cowork to LinkedIn?

  1. Open Customize, then Connectors.
  2. Click +, choose Add custom connector, and paste the URL.
  3. Sign in to Iridium and click Allow.

Cowork shares connectors with Claude. If you already added Iridium in Claude, it is already available in Cowork.

How do I connect Cursor to LinkedIn?

  1. Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json to have it in every project:
{
  "mcpServers": {
    "iridium": { "url": "https://api.iridiumhqmcp.com/mcp" }
  }
}

Cursor opens the Iridium sign-in the first time it connects. Click Allow. The tools then show under Settings, then MCP.

How do I connect ChatGPT to LinkedIn?

  1. Turn on Developer mode. It is under Settings, then Connectors, then Advanced.
  2. Open Plugins, then Browse plugins, and click +.
  3. Name it Iridium and paste the URL into Connection.
  4. Set Authentication to OAuth, tick I understand and want to continue, and create it.
  5. ChatGPT sends you to Iridium. Sign in and click Allow.

Developer mode needs a paid ChatGPT plan. ChatGPT warns you that OpenAI has not reviewed this server. That is expected.

How do I connect Hermes to LinkedIn?

  1. Run hermes mcp add iridium --url https://api.iridiumhqmcp.com/mcp, or add it by hand under mcp_servers in ~/.hermes/config.yaml with that url.
  2. In a running session, type /reload-mcp.
  3. Approve the Iridium sign-in when Hermes opens it.

How do I connect a custom agent to LinkedIn?

Point any MCP client at the URL. An unauthenticated request gets a 401 with an RFC 9728 resource_metadata challenge that leads to the protected resource and authorization server metadata. Register with RFC 7591 dynamic client registration at /oauth/register, then run the authorization code flow with PKCE (S256 only) and send the token as a bearer header. There is nothing to apply for and no key to request by email.

The OpenAPI description is at https://api.iridiumhqmcp.com/openapi.json, the MCP server card at /.well-known/mcp/server-card.json, and the full walkthrough at auth.md.

Questions people ask next

Can I connect more than one agent to the same LinkedIn account?

Yes. Each agent approves the sign-in once and gets its own token. Every agent acts as you, shares the same daily caps, and writes to the same activity log, so nothing an agent does is hidden from the others or from you. Disconnecting LinkedIn in Settings stops every agent at once.

Should I connect LinkedIn with my credentials or my li_at cookie?

Credentials on Unipile's hosted page is the simplest route and handles two-factor prompts for you. The li_at cookie is for when you would rather not type a LinkedIn password anywhere. Either way Iridium never stores your password. If you sign out of LinkedIn in the browser you copied the cookie from, that session ends and you reconnect.

Do I need a different URL for each agent?

No. One URL, every agent. What differs is where each client asks you to paste it, which is what the steps above cover.

What does clicking Allow give the agent?

A token scoped to act as you through Iridium's tools: search, read, draft, comment, message, publish, and read the log. Every outgoing action is a draft that waits for your approval, and every attempt is written to the activity log. See what Iridium does with your data for the caps and the retention table.

Do I need an agent at all?

No. Iridium is a complete web app with the same inbox, queues, and log. The MCP server is a second surface for people who would rather work from their agent.

Connect your agent in five minutes

7-day free trial. No credit card. Cancel anytime.

Start free → Read the FAQ