notes-mcp

An MCP server that exposes your local Markdown notes to AI assistants. Supports keyword search across all .md files in a directory.

Tools

search_notes

Searches all notes using term-frequency scoring and returns ranked results with snippets.

Related MCP server: mcp-recall-md

Setup

1. Install dependencies

npm install

2. Build

npm run build

3. Configure

Set the NOTES_DIR environment variable to the directory containing your .md files:

export NOTES_DIR=/path/to/your/notes

4. Add to your MCP client

In Claude Code (~/.claude/claude_desktop_config.json or similar):

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/path/to/notes-mcp/build/index.js"],
      "env": {
        "NOTES_DIR": "/path/to/your/notes"
      }
    }
  }
}

Requirements

• Node.js 18+

• Markdown notes in a flat directory (subdirectories are not searched)