API Docs/Guides/MCP Integration

Guide

MCP IntegrationBeta

The LinkedMash saved posts MCP server connects AI assistants to your LinkedIn saved posts over the Model Context Protocol. Tools like Claude can search, filter, label, and manage your saved posts through natural-language commands.

MCP access requires an active API token, available on the Pro and Lifetime plans. Generate one from Settings → Developer API.

What is MCP?

The Model Context Protocol is an open standard that lets AI assistants securely access external data and tools. The LinkedMash MCP server gives your assistant direct, scoped access to your bookmarks — enabling powerful automation and organization without copy-pasting between apps.

Natural language

Ask your assistant to find and organize bookmarks with plain commands — no query syntax.

Smart search

Semantic search across every saved post, with relevance ranking your assistant understands.

Auto organization

Automatically categorize and label bookmarks based on their content and your rules.

Prerequisites

Three things before you connect:

LinkedMash API token

Generate one from Settings → Developer API. Requires a Pro or Lifetime plan.

MCP-compatible assistant

Any client that supports the Model Context Protocol — Claude Desktop, Raycast, Cursor, and more.

LinkedMash MCP service

Connect any MCP client to the hosted Linkedmash server.

Getting started

Generate a LinkedMash API token

From your dashboard:

Open your LinkedMash dashboard
Go to Settings → Developer API
Click Generate new token
Copy the token — you'll need it in the next step

Your token is sensitive. Treat it like a password — never commit it to source control or share it publicly.

Choose your setup method

Add Linkedmash to your client

Add the hosted Linkedmash MCP server to your client's config file:

claude_desktop_config.json

{
  "mcpServers": {
    "linkedmash": {
      "url": "https://mcp.linkedmash.com/api/mcp?token=your-token-here"
    }
  }
}

Config file locations

Claude Desktop — ~/.claude/claude_desktop_config.json
Other clients — check your client's documentation

Test your connection

Once configured, restart your client and ask your assistant any of these:

“Show me my recent bookmarks”
“Find bookmarks about technology”
“How many bookmarks do I have?”
“List my labels”

If the assistant responds with your real bookmarks, you're connected. No response? Jump to troubleshooting.

Available tools

The MCP server exposes these tools to your assistant:

Saved posts

list_bookmarks

List your saved LinkedIn posts with filters and pagination.

search_bookmarks

Keyword or semantic (meaning-based) search across saved posts.

get_bookmark

Fetch a single saved post by its id.

get_bookmark_count

Get the total count of saved posts.

list_labels

List all your labels.

add_labels

Add labels to saved posts.

remove_labels

Remove labels from saved posts.

setup_vector_store

Initialize semantic search for your library.

Content Studio

These tools require a paid Creator or Lifetime plan.

create_draft

Create a LinkedIn post draft.

list_drafts

List your drafts, scheduled and published posts.

get_draft

Get a single draft by id.

update_draft

Update a draft.

delete_draft

Delete (move to trash) a draft.

upload_media

Host an image, video or PDF and get a URL to attach to a post.

Scheduling

These tools require a paid Creator or Lifetime plan.

schedule_post

Schedule a draft (now, next free slot, or a specific time) or publish immediately.

get_queue

List your posting queue — scheduled and published posts.

get_posting_slots

Get the next free posting slots from your schedule.

cancel_scheduled_post

Cancel a scheduled post.

get_posting_schedule

Get your recurring posting schedule (slot grid and timezone).

set_posting_schedule

Set your recurring posting schedule (slot grid and timezone).

Analytics

These tools require a paid Creator or Lifetime plan.

get_analytics

Account-level LinkedIn analytics (impressions, reactions, comments, reshares, followers).

get_post_analytics

Per-post analytics for recently published posts.

API endpoints reference

MCP tools call these LinkedMash endpoints under the hood. You can use them directly in your own apps too:

GET/v1/bookmarks

Retrieve bookmarks with filtering and pagination. Powers list_bookmarks and search_bookmarks.

GET/v1/labels

Get all user labels. Powers the list_labels tool.

POST/v1/labels/add

Add labels to posts. Powers the add_labels tool.

Supported AI clients

Claude Desktop

Official Claude app with native MCP support. Config: ~/.claude/claude_desktop_config.json · Setup guide

Raycast

Raycast AI with MCP integration. See the Raycast docs for setup.

Other MCP clients

Any assistant that supports the Model Context Protocol. Check your client's documentation for MCP setup.

Frequently asked questions

How does the AI assistant access my bookmarks?

It connects to your LinkedMash account through MCP using your API token. Data is only accessed when you make a specific request — nothing runs in the background.

Can I customize the assistant's behavior?

Yes. Give the assistant instructions on how to organize, categorize, or present your bookmarks, and it follows your preferences for the session.

Is my data secure?

Your API token is scoped to your account and the assistant only reads your bookmarks when you ask. LinkedMash doesn't share your data with third parties.

Additional resources

MCP Documentation

The official Model Context Protocol specification and guides.

Getting Started

Fetch saved posts