MCP Notes Server

A small Model Context Protocol (MCP) server that gives an AI a personal notes / todo store. Built for learning.

What is MCP?

MCP is an open standard that lets an AI model call functions in your code. You expose tools (functions with a name, description, and typed inputs); the AI reads the descriptions and decides when to call them. Communication here happens over stdio — the AI client launches notes-server.js and exchanges JSON messages over stdin/stdout.

Tools in this server

Tool	What it does
add_note	Add a new note/todo
list_notes	List notes (filter: all / open / done)
search_notes	Search notes by keyword
complete_note	Mark a note done by id
delete_note	Delete a note by id

Notes are saved to notes.json next to the server, so they survive restarts.

Run it

npm install
npm start        # prints "notes-server running on stdio" then waits

It looks like it "hangs" — that's correct. It's waiting for an AI client to talk to it over stdin. Press Ctrl+C to stop.

Connect it to Claude Code (CLI)

claude mcp add notes -- node /home/tw/Documents/mcp/notes-server.js

Then in a Claude Code session, try: "Add a note to buy milk", then "list my open notes".