LinkedIn MCP Server

Post to LinkedIn from Claude. A Model Context Protocol (MCP) server that lets Claude Desktop, Claude Code, and any MCP-compatible AI assistant publish posts, upload images, and manage company pages on LinkedIn — using natural language.

Imagine asking Claude "draft a LinkedIn post about my latest project and publish it" — and it just happens. That's what this MCP server enables.

✨ Features

💬 What it looks like

Once connected, just talk to Claude naturally:

You:    Draft a LinkedIn post announcing my new open-source project and publish it.

Claude: Here's a draft:

        🚀 Just open-sourced linkedin-mcp-server — an MCP server that lets
        Claude post to LinkedIn directly. No more copy-pasting drafts.

        Built with TypeScript and the LinkedIn REST API. Star on GitHub if
        you find it useful!

        Should I post this?

You:    Yes, publish it.

Claude: ✅ Posted. URN: urn:li:share:7339284...

Other things you can ask:

• "Look up the LinkedIn page for OpenAI and tell me how many followers they have"
• "Delete my last LinkedIn post"
• "Edit my latest post to add a link to the docs"
• "Share this article on LinkedIn with a short intro: https://..."

Before you start

You need three things installed on your computer:

1. Node.js (v18 or later) — download here
2. Claude Desktop — download here
3. A LinkedIn access token (explained in Step 2 below)

Step 1 — Download and build the server

Open your Terminal and run these commands one by one:

git clone https://github.com/abhineet34/linkedin-mcp-server.git
cd linkedin-mcp-server
npm install
npm run build

When it finishes, you'll have a dist/ folder. That's the built server.

Note down the full path to this folder — you'll need it in Step 3. To get it, run:

pwd

It will print something like /Users/yourname/linkedin-mcp-server. Remember this.

Step 2 — Get a LinkedIn Access Token

This is the trickiest part. LinkedIn's developer portal has some quirks — follow these steps in order and you'll be fine.

2a. Create a LinkedIn Company Page (required, even for personal use)

LinkedIn forces every developer app to be linked to a Company Page — a personal profile URL will not work, and the "Member Data Portability" default page blocks access to all useful products. So you must create a real Company Page first.

1. Go to linkedin.com/company/setup/new
2. Choose Company
3. Fill in:
   • Name — your name, brand, or anything (e.g. "Your Name", "Yourname Dev")
   • LinkedIn public URL — auto-fills from the name
   • Industry — pick Software Development (or whatever fits your actual work)
   • Organization size — 0–1 employees
   • Organization type — Self-employed
   • Logo — optional, any image
4. Check the verification box and click Create page

The page can stay empty — it just needs to exist.

2b. Create the developer app

1. Go to LinkedIn Developer Portal and sign in
2. Click Create app
   • App name — anything (e.g. "My MCP")
   • LinkedIn Page — search for the page you just created and select it (don't paste a URL)
   • App logo — any image
   • Accept the legal agreement, click Create app

2c. Add required Products to the app

This is the step most people miss. Adding scopes alone is not enough — you also have to add the Products that provide those scopes.

1. Open your app and go to the Products tab
2. Click Request access on these two products:
   • Sign In with LinkedIn using OpenID Connect — provides openid, profile, email
   • Share on LinkedIn — provides w_member_social
3. Both are auto-approved instantly (no waiting). Refresh the page — they should appear under "Added products"

If "Request access" is grayed out with a tooltip about Member Data Portability, you skipped Step 2a. Create a real Company Page, then create a new app linked to it (the old app cannot be fixed).

2d. Add a redirect URL

1. Go to the Auth tab of your app
2. Find "Authorized redirect URLs for your app" and click the pencil icon
3. Add this URL exactly:
   Code

   Copy

   https://www.linkedin.com/developers/tools/oauth/redirect
   

4. Save

This is LinkedIn's own redirect URL — required for the token generator to work.

2e. Generate the access token

1. Go to linkedin.com/developers/tools/oauth/token-generator
2. Select your app from the dropdown
3. Check all four scopes:
   • ☑ openid
   • ☑ profile
   • ☑ email
   • ☑ w_member_social
4. Click Request access token
5. LinkedIn will pop up an authorization screen — click Allow
6. You'll see a long token starting with AQX... — copy it now (you only see it once)

Your token expires after 60 days. When it stops working, come back to this step and generate a new one.

Step 3 — Connect to Claude Desktop

1. Open Claude Desktop

2. Go to Settings → Developer → Edit Config

   This opens a file called claude_desktop_config.json. Add the following inside it (replace the placeholder values):

{
  "mcpServers": {
    "linkedin": {
      "command": "node",
      "args": ["/Users/yourname/linkedin-mcp-server/dist/index.js"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "paste-your-token-here"
      }
    }
  }
}

• Replace /Users/yourname/linkedin-mcp-server with the path you noted in Step 1
• Replace paste-your-token-here with the token from Step 2

3. Save the file and restart Claude Desktop

Step 4 — Test it

In Claude Desktop, try:

"What's my LinkedIn profile?"

Claude should respond with your name, email, and a long ID starting with urn:li:person:.... If it does — you're all set!

💡 Save your URN. The response includes something like urn:li:person:izbpuvq9Vz. This is your unique LinkedIn ID — Claude needs it as the author_urn when creating posts. You can just ask Claude "remember my LinkedIn URN" or copy it somewhere safe.

Example things you can ask Claude

Once connected, just talk to Claude naturally:

• "Post on LinkedIn: Excited to share my new project!"
• "Create a LinkedIn post sharing this article: https://..."
• "Delete my last LinkedIn post"
• "How many followers does the Microsoft LinkedIn page have?"
• "Look up the LinkedIn page for OpenAI"

Troubleshooting

LinkedIn rejects my personal profile URL when creating an app

• LinkedIn only accepts Company Page URLs, not personal profile URLs (/in/...)
• Go to Step 2a and create a Company Page first — your "company" can be just your name

"Request access" buttons are grayed out on the Products tab

• This happens if you selected "Member Data Portability (Member-only default Company Page)" when creating the app
• That default page locks all products. You need to create a real Company Page (Step 2a) and then create a brand new app linked to it — the existing app can't be fixed

Token generator says "no scopes available"

• You skipped Step 2c. Go to your app's Products tab and add "Sign In with LinkedIn using OpenID Connect" and "Share on LinkedIn"
• Wait a minute, refresh, then try the token generator again

"redirect_uri does not match" error in the token generator

• You skipped Step 2d. Go to the Auth tab and add https://www.linkedin.com/developers/tools/oauth/redirect as an authorized redirect URL

Claude says it can't find the LinkedIn tool

• Make sure you restarted Claude Desktop completely after editing the config file (Quit and reopen, not just close the window)
• Double-check the file path in the config points to dist/index.js and the file actually exists at that path
• Run the path in Terminal with ls <path> to confirm

"Unauthorized" or 401 error

• Your access token may have expired (they last 60 days)
• Go back to Step 2e and generate a new one, then update the config file and restart Claude Desktop

"Permission denied" or 403 error

• The action requires a scope you didn't include
• For posting, make sure all four scopes were checked in Step 2e
• Some tools (like reading other people's posts) require LinkedIn-approved scopes that aren't available to all developers

Node.js not found

• Install Node.js from nodejs.org and try again

Available Tools

✅ Verified working with self-serve scopes

These tools work with the standard scopes anyone can grant themselves (openid, profile, email, w_member_social) and have been tested end-to-end:

⚠️ Approval-gated (not tested with self-serve scopes)

These tools require LinkedIn-approved scopes that are not available to all developers. They're included in the codebase for users who have partner-level access (e.g., approved Marketing Developer Platform, Community Management API, or Page Admin programs), but they have not been verified end-to-end with the standard self-serve flow described in this README.

If you have approved access to these scopes and successfully use any of these tools, please open an issue or PR — we'd love to confirm them as verified and document any quirks.

🛠️ Tech stack

• TypeScript — fully typed, strict mode
• @modelcontextprotocol/sdk — official MCP SDK
• Zod — runtime schema validation
• Axios — HTTP client
• LinkedIn REST API v202604 (configurable via LINKEDIN_API_VERSION env var; v2 fallback used only for OIDC userinfo)

The codebase is intentionally small and easy to extend — one file per tool domain (profile, posts, media, organizations).

🤝 Contributing

Issues and PRs are welcome! If you have an idea, find a bug, or want to add a new LinkedIn API tool, open an issue first to discuss.

Ideas for contributions:

• Add tools for LinkedIn comments and reactions
• Add scheduled post support
• Add carousel post support (multi-image)
• Improve error messages with more context
• Add a CLI mode for direct usage outside MCP clients

🔗 Related projects

• Model Context Protocol — the open standard this server is built on
• Anthropic Claude — the AI assistant this server is primarily designed for
• MCP Server Registry — a curated list of MCP servers
• Claude Desktop — install to use this server with Claude

⚠️ Disclaimer

This is an unofficial integration. It is not affiliated with, endorsed by, or sponsored by LinkedIn Corporation. Use responsibly and within LinkedIn's API terms of service.

⭐ Star the repo

If this saved you time, star the repo — it helps other developers find it.

License

MIT © Abhineet Pratap Singh