LinkedMash MCP server

LinkedMash

LinkedMash imports your LinkedIn saved posts into a searchable library and auto-syncs them to Notion, Google Sheets, Airtable, and Miro, with a REST API and an MCP server so AI agents such as Claude, ChatGPT, Cursor, and Codex can search and manage the same library.

This repository is the public home of the LinkedMash developer surface: the hosted MCP server, the @linkedmash/mcp npm package, the REST API, and the agent skill. The product itself lives at linkedmash.com. The service source code is not published in this repository.

Connect an AI agent over MCP

LinkedMash runs a hosted MCP server, so there is nothing to install. Add it to your MCP client config:

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

Or send the token as a header instead of a URL parameter:

https://mcp.linkedmash.com/api/mcp
Authorization: Bearer <your-token>

Prefer the header form where your client supports it; the URL form exists for clients that cannot set headers, and query strings can end up in request logs.

Create a token at linkedmash.com/integrations/api (login required). Note: the server accepts the initial MCP handshake before checking your token, so a wrong token shows up as a failure on the first tool call, not at connect time.

Per-client setup for Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Codex, OpenClaw, and ChatGPT: Connect Your Agent.

Local MCP server (npm)

Prefer a local stdio server? The same tools ship as @linkedmash/mcp:

LINKEDMASH_TOKEN=<your-token> npx -y @linkedmash/mcp

REST API

The REST API lives at https://api.linkedmash.com/v1 with Bearer authentication (saved posts are called bookmarks in the API):

curl -H "Authorization: Bearer <your-token>" "https://api.linkedmash.com/v1/bookmarks"

Start here:

• Getting Started
• Agent Quickstart
• MCP Tools
• Webhooks

Agent-readable Markdown versions exist for most doc pages: append .md to an api-docs URL, or start from llms.txt.

Agent skill

Teach a coding agent to drive LinkedMash end to end:

npx skills add linkedmash/agent-skills

Skill repo: linkedmash/agent-skills · Docs: Skills

What LinkedMash does

• Imports the posts you save on LinkedIn, text and media included, via a Chrome extension
• Full-text and AI search, labels, and smart folders across your whole library
• Auto-sync to Notion, Google Sheets, Airtable, and Miro
• Download your saved posts as CSV, JSON, or PDF
• An AI assistant that answers questions across your saves
• A Composer to draft, schedule, auto-publish, and analyze LinkedIn posts

Links

• Website: linkedmash.com
• For AI agents: linkedmash.com/for-ai-agents
• API docs: linkedmash.com/api-docs/getting-started
• npm: @linkedmash/mcp

Support

Questions or problems with the MCP server or API? Open an issue or reach out via linkedmash.com.