Skip to main content
Glama

mcp-snippetbox

MCP server template I base new tools on

Small but I use it weekly.

Install

pip install -r requirements.txt

Related MCP server: Sticky Notes MCP Server

Highlights

  • Includes a Claude Desktop config snippet with absolute paths

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

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

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

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

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

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

Project structure

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

Development

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

License

MIT licensed, see LICENSE.

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