linkedin-pages-mcp

linkedin-pages-mcp

MCP server for managing LinkedIn Company Pages via the official Community Management API. Post content, manage comments, track analytics, and more — all through the Model Context Protocol.

This is the first MCP server for LinkedIn Company Page management using LinkedIn's official API.

Features

| Category | Tools | |----------|-------| | Posts | Create, list, get, update, delete posts (text, images, articles, polls) | | Comments | Read, create, and delete comments on behalf of the company page | | Reactions | Read reactions, react to posts (LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION) | | Analytics | Follower stats and demographics, page views/clicks, per-post engagement | | Media | Initialize image uploads for rich media posts | | Organization | Get company page details (name, industry, website, staff count) |

16 tools total. All using LinkedIn's official REST API with proper OAuth 2.0 authentication.

Prerequisites

1. A LinkedIn Developer Application associated with your company page
2. Community Management API product enabled (apply via the Products tab)
3. An OAuth 2.0 access token from a user who is an admin of the company page
4. Your LinkedIn Organization ID (the numeric ID from your company page URL)

Getting your Organization ID

Your company page URL looks like https://www.linkedin.com/company/111806031/ — the number is your Organization ID.

Getting an access token

LinkedIn uses 3-legged OAuth 2.0. You need these scopes:

• w_organization_social — post and comment on behalf of the company
• r_organization_social — read posts, comments, and engagement
• rw_organization_admin — manage page and read analytics

See LinkedIn OAuth documentation for the full flow.

Installation

pip install linkedin-pages-mcp

Or from source:

git clone https://github.com/MCPWorks-Technologies-Inc/linkedin-pages-mcp.git
cd linkedin-pages-mcp
pip install -e .

Configuration

Set environment variables:

export LINKEDIN_ACCESS_TOKEN="your-oauth-token"
export LINKEDIN_ORGANIZATION_ID="111806031"

Or create a .env file (see .env.example).

Usage

With Claude Code / Cursor / any MCP client (stdio)

Add to your .mcp.json:

{
  "mcpServers": {
    "linkedin-pages": {
      "command": "linkedin-pages-mcp",
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your-oauth-token",
        "LINKEDIN_ORGANIZATION_ID": "111806031"
      }
    }
  }
}

Then ask your AI assistant:

"Post an update to our LinkedIn company page about our latest release"

"Show me our LinkedIn page analytics for this month"

"Reply to the latest comments on our most recent post"

With MCPWorks (remote, token-efficient)

Add as an MCP server plugin on your MCPWorks namespace:

"Add the LinkedIn Pages MCP server to my namespace"

Then your MCPWorks functions can call LinkedIn tools from inside the sandbox:

from functions import mcp__linkedin_pages__linkedin_get_posts
from functions import mcp__linkedin_pages__linkedin_get_follower_stats

posts = mcp__linkedin_pages__linkedin_get_posts(count=5)
stats = mcp__linkedin_pages__linkedin_get_follower_stats(time_granularity="MONTH")

top_post = max(posts['elements'], key=lambda p: p.get('engagement', 0))
result = {
    'followers': stats.get('followerCount'),
    'top_post': top_post.get('commentary', '')[:100],
    'total_posts': len(posts['elements']),
}

All LinkedIn data stays in the sandbox. Only the summary returns to the AI context.

Available Tools

Posts

| Tool | Description | |------|-------------| | linkedin_create_post | Create a text, article, or media post on the company page | | linkedin_get_posts | List recent posts (paginated, sorted by last modified) | | linkedin_get_post | Get a single post by ID | | linkedin_update_post | Update post text/commentary | | linkedin_delete_post | Delete a post |

Comments

| Tool | Description | |------|-------------| | linkedin_get_comments | Get comments on a post | | linkedin_create_comment | Comment on a post as the company page | | linkedin_delete_comment | Delete a comment |

Reactions

| Tool | Description | |------|-------------| | linkedin_get_reactions | Get reactions on a post | | linkedin_react_to_post | React to a post as the company page |

Analytics

| Tool | Description | |------|-------------| | linkedin_get_follower_stats | Follower counts and growth over time | | linkedin_get_page_stats | Page views and clicks | | linkedin_get_post_stats | Per-post engagement (impressions, clicks, likes, comments, shares) | | linkedin_get_follower_demographics | Follower breakdown by location, seniority, industry, company size |

Media

| Tool | Description | |------|-------------| | linkedin_init_image_upload | Get an upload URL and media URN for image posts |

Organization

| Tool | Description | |------|-------------| | linkedin_get_organization | Get company page details |

LinkedIn API Limits

| Tier | Calls/App/Day | Calls/Member/Day | Webhooks | |------|---------------|-------------------|----------| | Development | 500 | 100 | No | | Standard | Unrestricted | Unrestricted | Yes |

Development tier is granted on application. Standard tier requires a video demo review by LinkedIn (~60 days).

License

MIT License. See LICENSE.

Built by MCPWorks Technologies Inc.