MCP Integration
Connect AI assistants to your LinkedMash bookmarks using the Model Context Protocol (MCP). Enable AI tools to search, filter, and manage your bookmarks through natural language commands.
What is MCP?
The Model Context Protocol (MCP) is a standard that allows AI assistants to securely access external data and tools. Our LinkedMash MCP service provides AI tools with direct access to your bookmarks, enabling powerful automation and organization capabilities.
Natural Language
Ask your AI assistant to find and organize bookmarks using simple commands
Smart Search
AI-powered search through your bookmarks with semantic understanding
Auto Organization
Automatically categorize and label bookmarks based on content
Prerequisites
LinkedMash API Token
Generate an API token from your LinkedMash account settings
MCP-Compatible AI Assistant
Use any AI assistant that supports the Model Context Protocol (Claude, Gemini, etc.)
LinkedMash MCP Service
Install and configure the LinkedMash MCP service on your system
🚀 Getting Started
Step 1: Generate LinkedMash API Token
Visit your LinkedMash account and generate an API token:
- Go to your LinkedMash dashboard
- Navigate to Settings → Integrations → API
- Click "Generate New Token"
- Copy the generated token (you'll need this for the next step)
Step 2: Choose Your Setup Method
Smithery (Recommended)
Use Smithery to deploy and manage your MCP server with zero configuration.
Quick Setup:
- 1. Visit Smithery LinkedMash Server
- 2. Under the section "Connect", follow the instructions
- 3. Add your LinkedMash API token when requested
Benefits: Zero setup, automatic updates, managed infrastructure
Manual Configuration
Set up the MCP service locally using STDIO transport.
STDIO Configuration:
{
"mcpServers": {
"linkedmash": {
"command": "npx",
"args": ["@linkedmash/mcp"],
"env": {
"LINKEDMASH_TOKEN": "your-token-here"
}
}
}
}Config file locations:
- • Claude:
~/.claude/claude_desktop_config.json - • Other clients: Check your client's documentation
Step 3: Test Your Connection
Once configured, test the connection by asking your AI assistant:
Try these commands:
- • "Show me my recent bookmarks"
- • "Find bookmarks about technology"
- • "How many bookmarks do I have?"
- • "List my labels"
Available Tools
API Endpoints Reference
The MCP tools internally use these LinkedMash API endpoints. You can also use them directly in your applications:
Retrieve bookmarks with filtering and pagination. Used by the list_bookmarks and search_bookmarks tools.
Get all user labels. Used by the list_labels tool.
Add labels to posts. Used by the add_labels_to_tweets tool.
Supported AI Clients
Claude Desktop
Official Claude desktop application with MCP support. Documentation
~/.claude/claude_desktop_config.jsonOther MCP Clients
Any AI assistant that supports the Model Context Protocol.
Frequently Asked Questions
How does the AI assistant access my bookmarks?
The AI assistant connects to your LinkedMash account through the MCP protocol using your API token. Your data remains secure and is only accessed when you make specific requests.
Can I customize the AI assistant's behavior?
Yes! You can provide specific instructions to the AI assistant about how you want it to organize, categorize, or present your bookmarks. The AI learns from your preferences over time.
Is my data secure?
Absolutely. Your API token is encrypted and the AI assistant only accesses your bookmarks when you explicitly request it. No data is stored or shared with third parties.
What's the difference between Smithery and manual setup?
Smithery provides a managed, hosted solution with automatic updates and zero maintenance. Manual setup gives you full control but requires you to manage the server yourself.