Notes MCP Server

A simple MCP (Model Context Protocol) server for saving, listing, and searching notes. Built with the MCP SDK and persists notes to a local JSON file.

Setup

npm install

Related MCP server: MCP Personal Tools Server

Run the server

npm start

Connect to Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop.

Available Tools

Example prompts to use with Claude

Add a note titled "Meeting" with content "Discuss Q3 roadmap on Friday"

List all my notes

Search my notes for "roadmap"

Data storage

Notes are saved to ./notes.json — a plain JSON file you can open, edit, or back up any time.

Tech stack

• MCP SDK @modelcontextprotocol/sdk

• Zod for input validation

• Node.js ESM ("type": "module")