Skip to main content
Glama
AAAdiaosbrk

mcp-snippetbox

by AAAdiaosbrk

mcp-snippetbox

A small MCP server exposing my notes to Claude Desktop

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

Related MCP server: MCP Notes Server

Install

pip install -r requirements.txt

Highlights

  • Includes a Claude Desktop config snippet with absolute paths

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

  • 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

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

Project structure

├── .github/
│   └── workflows/
│       └── ci.yml
├── docs/
│   ├── configuration.md
│   ├── development.md
│   └── usage.md
├── tests/
│   └── test_notes.py
├── .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

Notes

  • mostly stable, edge cases remain

License

MIT. Do whatever you want.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    A beginner-friendly MCP server for managing personal notes. Enables Claude to create, list, read, search, update, and delete notes saved as Markdown files.
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A Python-based MCP server for Claude Desktop that enables you to save, append, read, and list local text notes, including appending Claude's responses.
    -
  • F
    license
    A
    quality
    C
    maintenance
    MCP server for managing ParchMark notes via Claude Code/Desktop. Provides tools to list, get, create, update, and delete notes through natural language.
    5
    -