Connect your AI agent to LinkedIn

Create your Iridium account, then add the Iridium URL to Claude, ChatGPT, Grok, Hermes or any MCP client, and your agent can work your LinkedIn: sorting the inbox, answering connection requests, finding people and scheduling actions. You approve every send.

MCP URL, the same for every agent: https://api.iridiumhqmcp.com/mcp

Iridium is not affiliated with, endorsed by, or sponsored by LinkedIn Corporation or Microsoft. See the terms.

On this page: Connect LinkedIn · Add to your agent · Claude Code · Hermes · What to ask · Troubleshooting · Questions

Step 1: Connect your LinkedIn (once)

Sign in at iridiumhqmcp.com/app with Google or GitHub. Signing in only identifies you; it does not touch LinkedIn. Then connect LinkedIn through Unipile, the session broker Iridium runs on. Either sign in on Unipile's hosted page, which handles two-factor prompts, or paste your li_at session cookie if you would rather not type a password anywhere. Unipile states it stores only an encrypted session token. Iridium never stores your password and holds only an opaque account handle. Disconnecting in Settings revokes the session immediately.

Step 2: Add Iridium to your agent

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

Claude, ChatGPT and Grok have their own pages: Claude + LinkedIn, ChatGPT + LinkedIn and Grok + LinkedIn. The rest are here.

Claude Code

Run claude mcp add --transport http iridium https://api.iridiumhqmcp.com/mcp, then type /mcp in a session and sign in when the browser opens.

Cowork

Open Customize, then Connectors. Click +, choose Add custom connector, paste the URL, sign in to Iridium and click Allow. Cowork shares connectors with Claude, so if you added it there, it is already here.

Hermes

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. In a running session type /reload-mcp, then approve the Iridium sign-in.

Cursor and other MCP clients

Add this to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for every project:

{ "mcpServers": { "iridium": { "url": "https://api.iridiumhqmcp.com/mcp" } } }

Any MCP client works. An unauthenticated request gets a 401 with an RFC 9728 resource_metadata challenge, and clients register through RFC 7591 dynamic registration at /oauth/register. The full walkthrough is in auth.md.

What should I ask my agent?

  • "Go through my unread LinkedIn messages and tell me which ones need an answer."
  • "Sort my pending connection requests into people I might hire, potential business partners, recruiters and sales pitches. Suggest accept or decline for each."
  • "Message Priya about Thursday's intro and schedule it for tomorrow morning."
  • "What did you do on my LinkedIn account yesterday?"

Troubleshooting

  • Your agent says LinkedIn needs reconnecting. Reconnect LinkedIn in Settings, then retry.
  • An action didn't go out. It may be waiting for your approval or deferred to the next day by your daily limit. Ask your agent "what did you do?" to read the activity log.
  • Still stuck. Email [email protected].

Questions people ask next

Can I connect more than one agent?

Yes. Each agent approves once, shares the same daily limits and activity log, and disconnecting LinkedIn in Settings stops all of them.

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. The li_at cookie is for when you would rather not type a password anywhere. If you sign out of LinkedIn in the browser you copied it from, that session ends and you reconnect.

Do I need a different URL for each agent?

No. One URL for every agent. Only where each client asks you to paste it differs.

Is there an official LinkedIn MCP server?

LinkedIn does not publish one for reading personal inboxes. Its official API has no general messaging product for third parties, so any server that reads your DMs uses an authenticated session.

Is it safe to connect my LinkedIn?

Every message, comment and connection request is a draft until you approve it, and limits are enforced on the server. Your password is never stored by Iridium. LinkedIn's terms restrict automated access, and accounts that use automation can be restricted, so you remain responsible for using Iridium within them. See security and data.

What does it cost?

$20 a month for one LinkedIn account, with a 7-day free trial and no card.

Can I delete my data?

Yes. Deleting your account revokes access and destroys your LinkedIn session immediately. We keep your account data for 30 days in case you come back, then permanently erase it. Profile and post data about other people is deleted after 7 days either way. Activity logs, which exclude credentials, are retained.

More

Claude + LinkedIn · ChatGPT + LinkedIn · Grok + LinkedIn

Connect your agent in five minutes

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

Start free → Read the FAQ