Skip to main content
Glama
janosdebugses

mcp-notes-server-x

mcp-notes-server-x

Learning MCP: tiny notes server with five tools

Started as a weekend hack, grew on me.

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

Related MCP server: AI Sticky Notes

Install

pip install -r requirements.txt

Features

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

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

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

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

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

  • Includes a Claude Desktop config snippet with absolute paths

Project structure

├── docs/
│   ├── development.md
│   ├── roadmap.md
│   └── usage.md
├── tests/
│   └── test_notes.py
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── SECURITY.md
├── requirements.txt
└── server.py

Development

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

Why

Needed this for myself; figured others might too.

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