Suprasuta Markdown MCP Server

by narashiman-kio.github.Narashiman-K/markdown-notes-mcpv0.1.4

Convert PDF, Word, Excel, PowerPoint, OpenDocument, EPUB, images and audio to clean Markdown, locally. An MCP server for Claude, VS Code and Antigravity.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active14d ago

Install Suprasuta Markdown MCP server

claude mcp add suprasuta-markdown -e GEMINI_API_KEY='<gemini-api-key>' -e ASSEMBLYAI_API_KEY='<assemblyai-api-key>' -- npx -y suprasuta-markdown-mcp

{
  "mcpServers": {
    "suprasuta-markdown": {
      "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "suprasuta-markdown": {
      "command": "npx",
      "args": [
        "-y",
        "suprasuta-markdown-mcp"
      ],
      "env": {
        "GEMINI_API_KEY": "<gemini-api-key>",
        "ASSEMBLYAI_API_KEY": "<assemblyai-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "suprasuta-markdown": {
      "type": "stdio",
      "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 in your workspace.

{
  "mcpServers": {
    "suprasuta-markdown": {
      "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.

Configuration

Variable	Required	Secret	Description
MARKDOWN_MCP_ROOTS	—	—	Semicolon-separated folders the server may read. Omit to allow any path.
GEMINI_API_KEY	—	yes	Optional. Enables cloud image recognition, which can also describe charts. Images are sent to Google only when cloud mode is chosen.
ASSEMBLYAI_API_KEY	—	yes	Optional. Enables audio transcription, the only feature that cannot run locally.

Freshness

Active — last maintenance signal 14d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-26 · 14d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-15 · 24d ago · official registry · v0.1.4

FAQ

›How do I install the Suprasuta Markdown MCP server in Claude Code?

Run: claude mcp add suprasuta-markdown -e GEMINI_API_KEY='<gemini-api-key>' -e ASSEMBLYAI_API_KEY='<assemblyai-api-key>' -- npx -y suprasuta-markdown-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Suprasuta Markdown require an API key?

Yes. It expects GEMINI_API_KEY, ASSEMBLYAI_API_KEY, of which 2 are secrets.

›Can I use Suprasuta Markdown as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Suprasuta Markdown in the official MCP registry?

Yes, as io.github.Narashiman-K/markdown-notes-mcp.