@Isteam/Linkedin

npm version License: MIT

MCP server for LinkedIn — post, comment, react, and manage content via AI agents.

Built by is.team — the AI-native project management platform.

Quick Start

Add to your MCP config (.mcp.json for Claude Code, or Claude Desktop settings):

{
  "mcpServers": {
    "linkedin": {
      "command": "npx",
      "args": ["-y", "@isteam/linkedin-mcp"],
      "env": {
        "LINKEDIN_ACCESS_TOKEN": "your-access-token",
        "LINKEDIN_PERSON_ID": "your-person-id"
      }
    }
  }
}

Tools (10)

Content & Engagement

Tool	Description
create_post	Create a LinkedIn text post (max 3000 characters)
create_article_post	Share an article link with commentary
delete_post	Delete a post by URN
comment_on_post	Comment on a post (max 1250 characters)
like_post	Like/react to a post

Profile & Analytics

Tool	Description
get_me	Get authenticated user info
get_post	Get a post by URN (text, author, stats)
get_comments	Get comments on a post
get_own_posts	Get your recent LinkedIn posts
get_post_stats	Get like/comment counts for a post

Environment Variables

Variable	Required	Description
LINKEDIN_ACCESS_TOKEN	Yes	OAuth 2.0 access token
LINKEDIN_PERSON_ID	Yes*	Your LinkedIn person ID (required in member mode)
LINKEDIN_ORGANIZATION_ID	No	Organization ID (for posting as a company page)
LINKEDIN_MODE	No	member (default) or organization

*Required when LINKEDIN_MODE is member (default).

Getting your credentials

1. Create an app in the LinkedIn Developer Portal
2. Request the w_member_social and r_liteprofile OAuth scopes
3. Complete the OAuth 2.0 flow to get an access token
4. Get your person ID from the /v2/userinfo endpoint

Organization mode

To post as a company page, set LINKEDIN_MODE=organization and provide LINKEDIN_ORGANIZATION_ID:

{
  "env": {
    "LINKEDIN_ACCESS_TOKEN": "your-access-token",
    "LINKEDIN_PERSON_ID": "your-person-id",
    "LINKEDIN_ORGANIZATION_ID": "your-org-id",
    "LINKEDIN_MODE": "organization"
  }
}

Rate Limits & Agent Safety

LinkedIn API enforces per-endpoint rate limits:

Endpoint	Limit	Notes
POST /rest/posts (create post)	1 req/sec, ~100/day	Stricter daily cap on content creation
POST /rest/socialActions/.../comments	2 req/sec
POST /rest/reactions (like)	1 req/sec
GET endpoints (posts, comments, stats)	~100 req/hour	Per authenticated user
General throttle	~60 req/min	Varies by endpoint scope

Idempotency note: LinkedIn does not deduplicate identical posts. If your agent retries on timeout, it may create duplicate content. Use get_own_posts to verify before retrying a create operation.

Backoff: When rate-limited, the API returns 429 with a Retry-After header (seconds). Wait the specified duration before retrying.

Usage Examples

Share a thought leadership post:

"Post on LinkedIn: AI agents are changing how teams collaborate. At is.team, we're building a future where AI joins your standups and ships features alongside you."

Share an article:

"Share this article on LinkedIn with a summary: https://example.com/article-about-ai"

Engage with your network:

"Get my recent LinkedIn posts and show their engagement stats"

About is.team

is.team is an AI-native project management platform where AI agents and humans collaborate as real teammates. AI agents join boards, create tasks, chat, and get work done — just like any other team member.

Part of the is.team open-source MCP ecosystem:

• @isteam/mcp — Project management
• @isteam/google-ads-mcp — Google Ads
• @isteam/twitter-mcp — Twitter/X
• @isteam/bluesky-mcp — Bluesky
• @isteam/linkedin-mcp — LinkedIn

License

MIT