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

---

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

Tool	What it does
add_note	Save a new note with a title and content
list_notes	List all saved notes
search_notes	Search notes by keyword

---

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")