LinkedMash
Search, label and export your LinkedIn saved posts, then draft, schedule and publish from them.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http linkedmash 'https://mcp.linkedmash.com/api/mcp' --header 'Authorization: <Bearer token. Create one at https://www.linkedmash.com/integrations/api>'
{
"mcpServers": {
"linkedmash": {
"type": "http",
"url": "https://mcp.linkedmash.com/api/mcp",
"headers": {
"Authorization": "<Bearer token. Create one at https://www.linkedmash.com/integrations/api>"
}
}
}
}
@linkedmash/mcpclaude mcp add linkedmash -e 'LINKEDMASH_TOKEN=<your linkedmash_token>' -- npx -y @linkedmash/mcp@1.2.0
{
"mcpServers": {
"linkedmash": {
"command": "npx",
"args": [
"-y",
"@linkedmash/mcp@1.2.0"
],
"env": {
"LINKEDMASH_TOKEN": "<your linkedmash_token>"
}
}
}
}
Environment variables
LINKEDMASH_TOKENrequired secret LinkedMash API token. Create one at https://www.linkedmash.com/integrations/api
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
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:
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.
Frequently asked questions
What is LinkedMash?
Search, label and export your LinkedIn saved posts, then draft, schedule and publish from them.
How do I install LinkedMash?
It runs as a remote server. In Claude Code: claude mcp add --transport http linkedmash 'https://mcp.linkedmash.com/api/mcp' --header 'Authorization: <Bearer token. Create one at https://www.linkedmash.com/integrations/api>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does LinkedMash need an API key?
Yes. It expects LINKEDMASH_TOKEN, Authorization, which you set in its configuration.
Is LinkedMash open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains LinkedMash?
It is published by linkedmash. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.