Skip to main content
Glama
StanislavOryshchukyo

mcp-notes-server-dev

mcp-notes-server-dev

Learning MCP: tiny notes server with five tools

Small but I use it weekly.

Getting started

pip install -r requirements.txt

Related MCP server: notes-box

Features

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

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

  • Includes a Claude Desktop config snippet with absolute paths

  • 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

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

Project structure

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

Acknowledgments

  • README structure inspired by popular OSS templates

  • Thanks to everyone opening issues with ideas

License

MIT licensed, see LICENSE.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables managing a local JSON notes file through five MCP tools: add, get, update, delete, and list notes, with atomic saves and a write lock.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables managing persistent notes through five tools: add, get, update, delete, and list, with atomic saves and clear error handling.
    MIT
  • 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 AI clients to add, retrieve, update, delete, and list notes persisted to a configurable JSON file, with atomic saves behind a write lock. It ships real docstrings for every tool so clients receive clear descriptions, plus a ready-to-paste Claude Desktop configuration snippet.
    MIT