Skip to main content
Glama
mcp-notes-server-dev

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.

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 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 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
    • 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