Skip to main content
Glama

mcp-snippetbox

MCP server template I base new tools on

Features

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

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

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

  • Includes a Claude Desktop config snippet with absolute paths

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

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

Related MCP server: mcp-snippetbox

Install

pip install -r requirements.txt

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

Project structure

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

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
      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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables creating, reading, updating, deleting, and listing notes persisted to a local JSON file, with the file path configurable via CLI flag or environment variable and atomic, lock-protected saves. Missing notes raise an error rather than returning a placeholder string.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI clients to add, get, update, delete, and list notes stored in a JSON file, with atomic saves and missing-note errors.
      MIT