Skip to main content
Glama

my-mcp-server

A small MCP server exposing my notes to Claude Desktop

Examples

# 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/my-mcp-server/server.py"],
#       "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
#     }
#   }
# }
python server.py --help

Related MCP server: notes-box

Getting started

pip install -r requirements.txt

Features

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

  • Includes a Claude Desktop config snippet with absolute paths

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

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

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

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

Project structure

├── .github/
│   └── ISSUE_TEMPLATE/
│       └── bug_report.md
├── docs/
│   ├── configuration.md
│   ├── faq.md
│   └── usage.md
├── examples/
│   └── quickstart.md
├── tests/
│   └── test_notes.py
├── .gitignore
├── SECURITY.md
├── 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.

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

    • 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.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude Desktop to add, retrieve, update, delete, and list notes kept in a JSON file, with the notes path configurable via an environment variable or CLI flag. Notes are persisted with atomic saves behind a write lock, and missing notes raise errors rather than returning placeholder text.
      MIT