Skip to main content
Glama
mcp-snippetbox

mcp-snippetbox

by gabiayakoizg

mcp-snippetbox

A small MCP server exposing my notes to Claude Desktop

Install

pip install -r requirements.txt

Related MCP server: notes-box

How to use

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

Highlights

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

  • Includes a Claude Desktop config snippet with absolute paths

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

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

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

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

Project structure

├── .github/
│   └── workflows/
│       └── ci.yml
├── docs/
│   ├── development.md
│   ├── faq.md
│   └── usage.md
├── tests/
│   └── test_notes.py
├── .editorconfig
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── LICENSE
├── SECURITY.md
├── requirements.txt
└── server.py

Development

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q

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

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude Desktop to add, get, and list notes, with state persisted to a JSON file in the home directory.
      MIT
    • 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 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.
      -