Taplio Linkedin Mcp

Taplio LinkedIn MCP Server

[](./LICENSE) [](https://modelcontextprotocol.io) [-brightgreen.svg)](#remote-taplio-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.

---

Contents

• [Remote Taplio MCP Server](#remote-taplio-mcp-server)
• [Prerequisites](#prerequisites)
• [Installation](#installation)
• [Claude Code](#claude-code)
• [Claude Desktop / claude.ai connectors](#claude-desktop--claudeai-connectors)
• [VS Code](#vs-code)
• [Cursor](#cursor)
• [Windsurf](#windsurf)
• [Generic MCP config](#generic-mcp-config)
• [Authentication](#authentication)
• [Toolsets](#toolsets)
• [Tools](#tools)
• [Profile](#profile)
• [Drafts](#drafts)
• [Publishing](#publishing)
• [Posts](#posts)
• [Analytics](#analytics)
• [Inspiration](#inspiration)
• [Recommended workflow](#recommended-workflow)
• [Library and lifecycle model](#library-and-lifecycle-model)
• [Limits and safety](#limits-and-safety)
• [Troubleshooting](#troubleshooting)
• [Contributing](#contributing)
• [License](#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](#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

1. An active Taplio account with LinkedIn connected.
2. An MCP-capable host (Claude Code, Claude Desktop, VS Code with Copilot, Cursor, Windsurf, or any client that

speaks MCP over HTTP).

1. A browser available on first connect, to complete the OAuth authorization.

---

Installation

Claude Code

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):

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

Cursor

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

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

Windsurf

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

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

Generic MCP config

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

{
  "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

1. Call [get_me](#get_me) once at the start of a session to load the user's voice, topics, language, and stats.
2. Use [search_inspiration](#search_inspiration) to ground new content in what is currently working in the niche.
3. Draft with [create_draft](#createdraft), iterate with [update_draft](#updatedraft).
4. Ship with [schedule_draft](#scheduledraft) (preferred) or [publish_draft](#publishdraft) (immediate).
5. Report with [get_analytics_overview](#getanalyticsoverview) and

[get_post_analytics](#getpostanalytics), and cross-reference with [list_posts](#list_posts).

---

Library and lifecycle model

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

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.

-

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: TaplioOfficial
• Source: TaplioOfficial/taplio-linkedin-mcp
• License: MIT
• Homepage: https://taplio.com

Install and usage instructions live in the source repository linked above.