This provides a structured way to serve and access markdown documentation from an MCP server for NPM packages, Go Modules, or PyPi packages. It
This provides a structured way to serve and access markdown documentation from an MCP server for NPM packages, Go Modules, or PyPi packages. It enables informed code generation by exposing these markdown files as resources or tools. Exposed over MCP by the markdown sidecar mcp mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.
Everything the assistant can do here goes through one of these:
workingDir — The working directory of your repopackageName — The name of the package or module to requestregistry — Registry the package will be found in (npm, gomodules, or pypi)docsSubDir — [OPTIONAL] The specific subdirectory to look for markdown docs in. Defaults to package rootmcpPrimitive — [OPTIONAL] The MCP primitive to expose from the server (tool or resource). This defaults to tool, some clients do not currently support resourcesInstallation goes through your MCP client rather than a global install: point it at markdown-sidecar-mcp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Among the file and storage access options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Markdown Sidecar MCP's toolset — workingDir, packageName, registry and 2 more — is a fair guide to whether it matches your workflow. It is maintained by lwsinclair; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Markdown Sidecar MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| workingDir | The working directory of your repo. |
| packageName | The name of the package or module to request |
| registry | Registry the package will be found in (npm, gomodules, or pypi) |
| docsSubDir | [OPTIONAL] The specific subdirectory to look for markdown docs in. Defaults to package root. |
| mcpPrimitive | [OPTIONAL] The MCP primitive to expose from the server (tool or resource). This defaults to tool, some clients do not currently support resources. |
{
"mcpServers": {
"markdown-sidecar": {
"command": "npx",
"args": ["-y", "markdown-sidecar-mcp"]
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.