dev-notes-server

A local MCP (Model Context Protocol) server that lets Claude save, list, and read developer notes as markdown files on your machine.

What It Does

Adds three tools to Claude Code:

Tool	Description
save_note	Save a note by title — creates or overwrites a .md file
list_notes	List all saved notes with their last-modified dates
read_note	Read a specific note's contents by title

Notes are stored in ~/dev-notes/ (e.g. C:\Users\yourname\dev-notes\ on Windows, /Users/yourname/dev-notes/ on Mac/Linux).

Setup

1. Install dependencies

npm install

2. Register with Claude Code

claude mcp add dev-notes -- node "/absolute/path/to/dev-notes-server/index.js"

Replace /absolute/path/to/dev-notes-server/ with the actual path to this folder on your machine.

Or manually add to ~/.claude/settings.json:

{
  "mcpServers": {
    "dev-notes": {
      "command": "node",
      "args": [
        "/absolute/path/to/dev-notes-server/index.js"
      ]
    }
  }
}

3. Verify the connection

Inside a Claude Code session run:

/mcp

You should see dev-notes listed as connected.

Usage

Once connected, just ask Claude naturally:

• "Save a note called 'setup-guide' with these steps..."
• "List my saved notes"
• "Read my 'setup-guide' note"

Tech Stack

• Runtime: Node.js (ES Modules)
• MCP SDK: @modelcontextprotocol/sdk
• Validation: zod
• Transport: stdio