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:

config.json

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

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

text

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:

bash

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

Terminal

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

Start here:

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:

Terminal

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

Support

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

LinkedMash README