# 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

```bash
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)

```bash
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"_.