Markdown Notes MCP
Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.4
- Listing updated
- 4 days ago
About Markdown Notes MCP
Markdown Notes MCP is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add markdown-notes-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env ASSEMBLYAI_API_KEY='<ASSEMBLYAI_API_KEY>' -- npx -y suprasuta-markdown-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"ASSEMBLYAI_API_KEY": "<ASSEMBLYAI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"ASSEMBLYAI_API_KEY": "<ASSEMBLYAI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"markdown-notes-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"ASSEMBLYAI_API_KEY": "<ASSEMBLYAI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"ASSEMBLYAI_API_KEY": "<ASSEMBLYAI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"markdown-notes-mcp": {
"command": "npx",
"args": [
"-y",
"suprasuta-markdown-mcp"
],
"env": {
"GEMINI_API_KEY": "<GEMINI_API_KEY>",
"ASSEMBLYAI_API_KEY": "<ASSEMBLYAI_API_KEY>"
}
}
}
}Configuration
MARKDOWN_MCP_ROOTSSemicolon-separated folders the server may read. Omit to allow any path.GEMINI_API_KEYOptional. Enables cloud image recognition, which can also describe charts. Images are sent to Google only when cloud mode is chosen.ASSEMBLYAI_API_KEYOptional. Enables audio transcription, the only feature that cannot run locally.
Pricing
Open source
Markdown Notes MCP FAQ
Is Markdown Notes MCP free?
Yes. Markdown Notes MCP is open source, so you can use and self-host it for free.
How do I add Markdown Notes MCP to Claude Code?
Run this command in your terminal: claude mcp add markdown-notes-mcp --env GEMINI_API_KEY='<GEMINI_API_KEY>' --env ASSEMBLYAI_API_KEY='<ASSEMBLYAI_API_KEY>' -- npx -y suprasuta-markdown-mcp
What are the best alternatives to Markdown Notes MCP?
The closest alternatives to Markdown Notes MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.
Alternatives to Markdown Notes MCP

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents