Skip to main content
Glama
mcp-notes-server

mcp-notes-server

mcp-notes-server

A small MCP server exposing my notes to Claude Desktop

Started as a weekend hack, grew on me.

Highlights

  • Includes a Claude Desktop config snippet with absolute paths

  • Atomic saves (temp file + os.replace) behind a write lock

  • Every tool carries a real docstring, so clients get descriptions

  • A missing note raises instead of returning the string 'not found'

  • Notes path set by MCP_NOTES_FILE or --notes-file

  • Five tools: add / get / update / delete / list notes

Related MCP server: mcp-snippetbox

Installation

pip install -r requirements.txt

Usage

# claude_desktop_config.json  (use ABSOLUTE paths: Claude does not
# run from the repo directory, so a bare "server.py" is not found)
# {
#   "mcpServers": {
#     "notes-box": {
#       "command": "python",
#       "args": ["/abs/path/to/mcp-notes-server/server.py"],
#       "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
#     }
#   }
# }
python server.py --help

Project structure

├── .github/
│   ├── workflows/
│   │   └── ci.yml
│   └── pull_request_template.md
├── docs/
│   ├── development.md
│   ├── roadmap.md
│   └── usage.md
├── examples/
│   └── quickstart.md
├── tests/
│   └── test_notes.py
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── requirements.txt
└── server.py

FAQ

Is this production ready?
It works for my use case; review the code before relying on it.

Why no framework?
The stdlib covers what this project needs.

License

MIT. Do whatever you want.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables managing personal notes through Claude Desktop with add, get, update, delete, and list tools, using atomic saves and a configurable notes file.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude Desktop to manage personal notes stored in a JSON file, supporting add, get, update, delete, and list operations with atomic saves.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude Desktop to add, retrieve, update, delete, and list personal notes persisted in a local JSON file, with atomic saves and configurable note storage paths.
      -