Markdrop MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Markdrop MCP Server Search my pastes for API architecture documentation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
___ ___ _ _
| \/ | | | | |
| . . | __ _ _ __ __| |_ __ | | ___ _ __
| |\/| |/ _` | '__/ _` | '_ \| |/ _ \| '_ \
| | | | (_| | | | (_| | | | | | (_) | |_) |
\_| |_/\__,_|_| \__,_|_| |_|_|\___/| .__/
| |
__ __ ____ ____ |_|
| \/ |/ ___| _ \
| |\/| | | | |_) |
| | | | |___| __/
|_| |_|\____|_|Markdown Knowledge Workspace for Agents
Give Claude Code instant access to shared documentation. Auto-sync markdown files, AI-tag them intelligently, and retrieve them contextually during development.
๐ Table of Contents
Related MCP server: SyncPen MCP Server
๐ฏ What is This?
This MCP server connects Claude Desktop to your Markdrop knowledge base. Combined with the Claude Code hook (which auto-captures markdown files), you get a complete RAG-powered development workflow:
๐ Hook: Auto-captures markdown docs โ Markdrop (with AI tagging)
๐ MCP: Claude retrieves relevant docs when needed โ Better context
๐ค Result: Your own docs become searchable knowledge for Claude
๐ Installation
The MCP server is included in your Markdrop installation at markdrop-mcp-server/. Dependencies are already installed.
1. Find Your Markdrop Path
cd /path/to/your/markdrop
pwd # Copy this path2. Get Your API Key
Create an API key in Markdrop: Dashboard โ API
3. Configure Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"markdrop": {
"command": "node",
"args": ["/absolute/path/to/your/markdrop/markdrop-mcp-server/index.js"],
"env": {
"MARKDROP_API_URL": "http://localhost:3000",
"MARKDROP_API_KEY": "md_xxxxxxxxxxxx",
"MARKDROP_PROJECT_ID": "optional-project-id"
}
}
}
}๐ก Pro Tips:
Use the absolute path to your
index.jsfileSet
MARKDROP_PROJECT_IDto auto-filter searches to a specific projectRun multiple MCP instances for multi-project workflows
4. Restart Claude Desktop
Fully quit and restart Claude Desktop. You'll see Markdrop tools appear! โจ
๐ ๏ธ Available Tools
๐ search_pastes
Search through your knowledge base by content, title, tags, or topics.
Parameters:
query(required) - Search query to match against content and titletags(optional) - Array of tags to filter by (e.g.,["architecture", "api"])category(optional) - Filter by categorydocumentType(optional) - Filter by type (e.g.,"architecture","decision-record")limit(optional) - Max results (default: 10)
Try asking:
"Search my pastes for API architecture documentation"
๐ get_paste
Retrieve full content and metadata for a specific paste.
Parameters:
pasteId(required) - The ID of the paste to retrieve
Try asking:
"Get the full content of paste abc123"
๐ท๏ธ list_tags
List all available tags with counts. Great for discovering what's documented.
Parameters:
category(optional) - Filter tags by categoryminCount(optional) - Minimum pastes per tag (default: 1)
Try asking:
"What tags do I have in my documentation?"
โฐ get_recent_pastes
Get recently created or modified pastes.
Parameters:
limit(optional) - Max results (default: 10)projectId(optional) - Filter by projectdocumentType(optional) - Filter by document type
Try asking:
"Show me my recent documentation"
๐ฌ How to Use
Once configured, just ask Claude naturally:
๐ญ "Search my pastes for authentication flow documentation"
๐ "What architecture docs do I have?"
๐ "Show me recent API documentation I've written"
๐๏ธ "Get the paste about database migrations"
Claude will automatically use these tools to find relevant context from your knowledge base.
๐ The Workflow
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 1. Create docs with Claude Code โ
โ โ (Hook auto-syncs with AI tagging) โ
โ 2. Stored in Markdrop โ
โ โ (Searchable, organized, tagged) โ
โ 3. Ask Claude questions โ
โ โ (MCP retrieves relevant docs) โ
โ 4. Claude responds with YOUR context โ
โ โ (Better answers, project-specific) โ
โ 5. Repeat โ Build knowledge base over time โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโThis creates a feedback loop where your development docs become searchable context for future work. The more you document, the smarter Claude gets about your project!
๐ง Troubleshooting
๐ค MCP server not showing in Claude Desktop?
โ Check config file:
~/Library/Application Support/Claude/claude_desktop_config.jsonโ Verify absolute path to
index.jsis correctโ Fully quit and restart Claude Desktop
๐ซ Authentication errors?
โ Verify
MARKDROP_API_KEYis correct (Dashboard โ API)โ Check Markdrop is running at the specified URL
โ Test manually:
curl -H "Authorization: Bearer md_xxxxxxxxxxxx" \ http://localhost:3000/api/pastes/search?query=test
๐ No results when searching?
โ Make sure you've created some pastes first
โ Verify they have tags (use Claude Code hook for auto-tagging)
โ Try a broader search query
โ Check your
MARKDROP_PROJECT_IDisn't filtering everything out
๐ Need an API key?
Create one in Markdrop: Dashboard โ API โ Create New Key
๐๏ธ Architecture
โโโโโโโโโโโโโโโโโโโ
โ Claude Desktop โ
โโโโโโโโโโฌโโโโโโโโโ
โ stdio (MCP Protocol)
โ
โโโโโโโโโโโโโโโโโโโ
โ MCP Server โ (@modelcontextprotocol/sdk)
โโโโโโโโโโฌโโโโโโโโโ
โ HTTP/Bearer Auth
โ
โโโโโโโโโโโโโโโโโโโ
โ Markdrop API โ (REST API)
โโโโโโโโโโโโโโโโโโโTech Stack:
@modelcontextprotocol/sdk- Standard MCP protocol implementationStdio Transport - Communicates with Claude via stdin/stdout
Markdrop REST API - Searches and retrieves pastes
Bearer Token Auth - Secure API authentication
๐งช Development
Test the server locally:
# Set environment variables
export MARKDROP_API_URL="http://localhost:3000"
export MARKDROP_API_KEY="md_xxxxxxxxxxxx"
# Run server (expects JSON input via stdin)
node index.js
# Or with inspector for debugging
node --inspect index.jsNote: The server logs to stderr, so debug output won't interfere with MCP communication.
๐ License
MIT
Made with โค๏ธ for the Claude Code community
Available Tools
4 toolsget_pasteA
Retrieve full content and metadata for a specific paste by ID
Inputs: pasteId (required).
get_recent_pastesA
Get recently created or modified pastes, optionally filtered by project or type
Inputs: limit, projectId, documentType.
list_tagsA
List all available tags with their counts and categories. Useful for discovering what topics are documented.
Inputs: category, minCount.
search_pastesA
Search through Markdrop pastes by content, title, tags, or topics. Returns matching pastes with metadata.
Inputs: query (required), tags, limit, category, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 4 tools
Each tool has a distinct purpose: searching, retrieving by ID, listing tags, and listing recent pastes. There is no overlap or ambiguity between them.
All tool names follow a consistent snake_case verb_noun pattern (e.g., search_pastes, get_paste, list_tags, get_recent_pastes). The naming is predictable and coherent.
With 4 tools, the server is well-scoped and focused on read/search operations. The count is within the ideal range and each tool contributes to the server's purpose.
The server only provides read and search operations; there are no create, update, or delete tools. This is a significant gap for a paste management service, as agents cannot write or manage pastes.
Related MCP Connectors
Connect your team's living knowledge base โ docs, data, issues, CRM โ to Claude and ChatGPT.
Your docs site. No editor to open. Just ask Claude.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Connect Claude to your Platform7n workspaces: chat, links, work and decks. One-click OAuth.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude Code to search and retrieve documents from an Outline knowledge base.2ISC
- AlicenseAqualityCmaintenanceConnects Claude Code to SyncPen documents as a knowledge base, enabling document search, reading, listing, creation, and update via natural language.2163 npmMIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude to a personal knowledge base with hybrid search over code, documents, and images. Allows the AI assistant to retrieve and answer from your own files during conversations.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables Claude to read and search a local Markdown knowledge base and past session transcripts, and write distilled notes back into it over MCP.5 npm1MIT