Taplio LinkedIn MCP Server

The Taplio LinkedIn MCP Server is a Model Context Protocol (MCP) server that connects AI tools directly to your Taplio account and, through it, to your LinkedIn presence. It gives AI agents, assistants, and chat clients the ability to draft, schedule, and publish LinkedIn posts, browse what you have already posted, research inspiration from other creators, and read your analytics, all through natural language.

Point your MCP host at the Taplio server and you can ask things like:

"Draft a LinkedIn post about our new MCP launch and schedule it for Tuesday 9am."
"Show me my last 10 posts and which one got the most impressions."
"Find 20 high-performing posts about linkedin ghostwriting from creators under 50k followers."
"How are my followers and engagement trending over the last 30 days?"

Use cases

Turning raw ideas into publish-ready LinkedIn posts, on your own voice and topics.
Automating draft creation, scheduling, and publishing from any MCP-capable client.
Building AI-assisted content workflows and reporting on top of your real LinkedIn data.
Extracting insights and analytics from your posting history without leaving your assistant.

Remote Taplio MCP Server
Prerequisites
Installation
Authentication
Toolsets
Tools
- Profile
- Drafts
- Publishing
- Posts
- Analytics
- Inspiration
Recommended workflow
Library and lifecycle model
Limits and safety
Troubleshooting
Contributing
License

Remote Taplio MCP Server

Taplio is offered as a hosted, remote MCP server. There is nothing to install or run locally: your MCP host connects to the Taplio endpoint over HTTP and authenticates with OAuth.

Property	Value
Transport	Streamable HTTP (remote)
Endpoint	`https://mcp.taplio.com`
Authentication	OAuth 2.0 (authorize in the browser, no API key to paste)
Scope	The authenticated user's own Taplio + LinkedIn account
Server hint	Call `get_me` first to load identity and settings

Because the server is remote and OAuth-based, you never copy a secret into a config file. Access is tied to the Taplio account you approve in the browser, and can be revoked from Taplio at any time.

Prerequisites

An active Taplio account with LinkedIn connected.
An MCP-capable host (Claude Code, Claude Desktop, VS Code with Copilot, Cursor, Windsurf, or any client that speaks MCP over HTTP).
A browser available on first connect, to complete the OAuth authorization.

Installation

Claude Code

Terminal

claude mcp add --transport http taplio https://mcp.taplio.com

Then run /mcp inside Claude Code and authorize taplio in the browser when prompted.

Claude Desktop / claude.ai connectors

In Claude Desktop or on claude.ai, open Settings -> Connectors -> Add custom connector, then enter:

Name: Taplio
URL: https://mcp.taplio.com

Approve the OAuth screen. The Taplio tools then appear in the tool picker.

VS Code

Add to your user or workspace MCP configuration (.vscode/mcp.json):

config.json

{
  "servers": {
    "taplio": {
      "type": "http",
      "url": "https://mcp.taplio.com"
    }
  }
}

Cursor

In ~/.cursor/mcp.json (or Settings -> MCP -> Add):

config.json

{
  "mcpServers": {
    "taplio": {
      "url": "https://mcp.taplio.com"
    }
  }
}

Windsurf

In ~/.codeium/windsurf/mcp_config.json:

config.json

{
  "mcpServers": {
    "taplio": {
      "serverUrl": "https://mcp.taplio.com"
    }
  }
}

Generic MCP config

Any client that supports remote MCP servers over HTTP can use:

config.json

{
  "mcpServers": {
    "taplio": {
      "type": "http",
      "url": "https://mcp.taplio.com"
    }
  }
}

Authentication

The Taplio MCP Server uses OAuth 2.0. On first use your client opens a browser window where you log in to Taplio and approve access. The server then acts on behalf of that single account. No API keys, tokens, or LinkedIn credentials are stored in your client config. Revoke access at any time from your Taplio account settings.

Toolsets

The tools are grouped into functional toolsets. All of them operate on the authenticated user's own account.

Toolset	Description
Profile	Identity, content preferences, and current LinkedIn stats.
Drafts	Create, read, list, edit, and delete unpublished post drafts.
Publishing	Publish a draft now, schedule it, or unschedule it back to drafts.
Posts	Browse scheduled, sending, and sent posts.
Analytics	Account-level overview and per-post performance metrics.
Inspiration	Search other creators' LinkedIn posts to model content on what works.

Tools

Profile

`get_me`

Read this first to orient. Returns the user's identity and content preferences so you can tailor output to them and recognize their own posts: display name and LinkedIn @handle (a user may go by several aliases, so check both), plus ai_settings (industry, role, language, target audience, topics, keywords, description) and today's LinkedIn stats (followers, connections, profile views).

No parameters.

Drafts

`create_draft`

Create a new LinkedIn post draft (unpublished). Publish it later with schedule_draft or publish_draft.

Parameter	Type	Required	Description
`content`	string	yes	The text body of the draft. 1 to 3000 characters.

`get_draft`

Fetch a single LinkedIn post draft by id.

Parameter	Type	Required	Description
`id`	string	yes	The id of the draft (from `list_drafts`).

`list_drafts`

List the user's unpublished LinkedIn post drafts.

Parameter	Type	Required	Description
`limit`	integer	no	Max drafts to return. Defaults to 25, capped at 100.
`cursor`	string	no	Pagination token from a previous response.

`update_draft`

Update the content of an existing draft. Only drafts can be edited: published or scheduled posts cannot.

Parameter	Type	Required	Description
`id`	string	yes	The id of the draft to update (from `list_drafts`).
`content`	string	yes	The new full text body (replaces existing). 1 to 3000 chars.

`delete_draft`

Permanently delete a LinkedIn post draft.

Parameter	Type	Required	Description
`id`	string	yes	The id of the draft to permanently delete.

Publishing

`publish_draft`

Publish a draft to LinkedIn immediately. This goes live now and cannot be undone.

Parameter	Type	Required	Description
`id`	string	yes	The id of the draft to publish immediately.

`schedule_draft`

Schedule a draft to be published automatically at a future time.

Parameter	Type	Required	Description
`id`	string	yes	The id of the draft to schedule (from `list_drafts`).
`scheduled_for`	string	yes	ISO 8601 datetime (e.g. `2026-06-10T14:30:00Z`). At least 2 minutes in the future.

`unschedule`

Unschedule a scheduled post, returning it to drafts so you can edit, reschedule, or delete it.

Parameter	Type	Required	Description
`id`	string	yes	The id of the scheduled post (from `list_posts`).

Posts

`list_posts`

List the user's LinkedIn posts (status scheduled, sending, or sent), most recent first. A draft becomes a post once it is scheduled or published.

Parameter	Type	Required	Description
`status`	enum	no	Filter by `scheduled`, `sending`, or `sent`. Omit for all three.
`from`	string	no	Only posts on or after this date (YYYY-MM-DD or ISO 8601, UTC).
`to`	string	no	Only posts on or before this date (YYYY-MM-DD or ISO 8601, UTC).
`limit`	integer	no	Max posts to return. Defaults to 25, capped at 100.
`cursor`	string	no	Pagination token from a previous response.

`get_post`

Fetch a single LinkedIn post by id. A post has status scheduled, sending, or sent; drafts are separate (use get_draft).

Parameter	Type	Required	Description
`id`	string	yes	The id of the post (from `list_posts`).

Analytics

`get_analytics_overview`

Get the user's LinkedIn analytics overview (followers, impressions, engagement). Defaults to today when no date range is given.

Parameter	Type	Required	Description
`from`	string	no	Start date (YYYY-MM-DD, UTC). Defaults to today; range capped at 90 days.
`to`	string	no	End date (YYYY-MM-DD, UTC). Defaults to today; range capped at 90 days.
`metrics`	string	no	Comma-separated subset: `followers, connections, profile_views, impressions, likes, comments, shares`. Omit for all.
`granularity`	enum	no	Time-bucket size; only `day` is supported (default).

`get_post_analytics`

List the user's per-post analytics (impressions, likes, comments, shares), defaulting to the last 7 days.

Parameter	Type	Required	Description
`from`	string	no	Start date (YYYY-MM-DD, UTC). Defaults to 7 days ago; range capped at 90 days.
`to`	string	no	End date (YYYY-MM-DD, UTC). Defaults to today; range capped at 90 days.
`limit`	integer	no	Max posts to return. Defaults to 25, capped at 100.
`cursor`	string	no	Pagination token from a previous response.

Inspiration

`search_inspiration`

Search LinkedIn posts from other creators to use as inspiration.

Parameter	Type	Required	Description
`query`	string	no	Free-text search over post content. Omit to browse top posts.
`lang`	string	no	Filter by ISO 639-1 language code (e.g. `en`, `fr`).
`min_likes`	integer	no	Only posts with at least this many likes. 0-1000; defaults to 50.
`min_comments`	integer	no	Only posts with at least this many comments. 0-1000; defaults to 0.
`min_char_count`	integer	no	Only posts with at least this many characters. 0-10000; defaults to 500.
`max_followers`	integer	no	Only posts whose author has at most this many followers. Defaults to 100000.
`min_days_old`	integer	no	Only posts at least N days old (0-365); defaults to 1. Overrides `from`/`to`.
`max_days_old`	integer	no	Only posts from the last N days (0-365). Overrides `from`/`to`.
`from`	string	no	Only posts on or after this date. Ignored if `min`/`max_days_old` is set.
`to`	string	no	Only posts on or before this date. Ignored if `min`/`max_days_old` is set.
`limit`	integer	no	Max posts to return. Minimum 1; defaults to 30.

Recommended workflow

Call get_me once at the start of a session to load the user's voice, topics, language, and stats.
Use search_inspiration to ground new content in what is currently working in the niche.
Draft with create_draft, iterate with update_draft.
Ship with schedule_draft (preferred) or publish_draft (immediate).
Report with get_analytics_overview and get_post_analytics, and cross-reference with list_posts.

Library and lifecycle model

A draft and a post are the same item at different stages of its life:

Code

create_draft ─┐
              ├─> [ DRAFT ] ──schedule_draft──> [ scheduled ] ──(auto)──> [ sending ] ──> [ sent ]
update_draft ─┘        │                              │
                       └──────publish_draft───────────┴──(immediate)──> [ sending ] ──> [ sent ]

                       [ scheduled ] ──unschedule──> [ DRAFT ]

Drafts live in the drafts list (list_drafts) and are the only editable stage.
Scheduling or publishing a draft turns it into a post and moves it to the posts list (list_posts).
unschedule moves a scheduled post back to drafts; a sent post cannot be un-sent.

Limits and safety

Post length: 1 to 3000 characters (create_draft, update_draft).
Scheduling: scheduled_for must be at least 2 minutes in the future, ISO 8601, UTC recommended.
Analytics range: capped at 90 days per query; paginate with cursor for large result sets.
Irreversible actions: publish_draft goes live immediately and delete_draft is permanent. Confirm intent before calling either.
Scope: every tool acts only on the authenticated user's own Taplio and LinkedIn account.

Troubleshooting

Tools do not appear: confirm the server URL is https://mcp.taplio.com and that you completed the OAuth browser step. Re-run /mcp (Claude Code) or reconnect the connector.
401 / auth errors: your session may have expired or been revoked. Reconnect and re-authorize in the browser.
Cannot edit a post: only drafts are editable. If it is already scheduled, call unschedule first; if it is sent, it can no longer be changed.
Empty analytics: newly published posts take time to accumulate metrics; also check your date range against the 90-day cap.

Contributing

This repository documents the Taplio LinkedIn MCP Server. See CONTRIBUTING.md for how to report issues with the documentation or suggest improvements. For product support, contact Taplio.

License

This project is licensed under the terms of the MIT License. See LICENSE.

Taplio LinkedIn MCP Server

Use cases

Contents

Remote Taplio MCP Server

Prerequisites

Installation

Claude Code

Claude Desktop / claude.ai connectors

VS Code

Cursor

Windsurf

Generic MCP config

Authentication

Toolsets

Tools

Profile

get_me

Drafts

create_draft

get_draft

list_drafts

update_draft

delete_draft

Publishing

publish_draft

schedule_draft

unschedule

Posts

list_posts

get_post

Analytics

get_analytics_overview

get_post_analytics

Inspiration

search_inspiration

Recommended workflow

Library and lifecycle model

Limits and safety

Troubleshooting

Contributing

License

`get_me`

`create_draft`

`get_draft`

`list_drafts`

`update_draft`

`delete_draft`

`publish_draft`

`schedule_draft`

`unschedule`

`list_posts`

`get_post`

`get_analytics_overview`

`get_post_analytics`

`search_inspiration`