# Markdown Notes MCP

> Markdown Notes MCP is an open-source MCP server for files and documents. Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/narashiman-k/markdown-notes-mcp
- **MCP Registry name:** io.github.Narashiman-K/markdown-notes-mcp
- **Categories:** files and documents, knowledge and memory
- **Listing updated:** 2026-11-13

## About

Convert PDF, Word, Excel, PowerPoint, EPUB and images to Markdown locally, with no upload.

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/markdown-notes-mcp
