notes-mcp-server (Python / MCPServer template)

The same tools as the TypeScript template: search_notes, add_note, the notes://all resource, and the weekly_review prompt.

Run & test

uv sync                       # or: pip install "mcp[cli]>=2.2"
uv run mcp dev server.py      # interactive MCP Inspector
node ../../../qa/mcp-smoke.mjs uv run server.py   # automated check (prints PASS)

Configuration

Env var	Default	Purpose
NOTES_FILE	~/.notes-mcp.json	Where notes are stored

Connect

Cursor (.cursor/mcp.json):

{ "mcpServers": { "notes": { "command": "uv", "args": ["--directory", "C:/path/to/python-server", "run", "server.py"] } } }

Claude Code:

claude mcp add notes -- uv --directory C:/path/to/python-server run server.py

For more clients, see Connect to clients.