mcp-notes-server-dev
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-notes-server-dev
Learning MCP: tiny notes server with five tools
Small but I use it weekly.
Getting started
pip install -r requirements.txtRelated 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 --helpProject 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.pyAcknowledgments
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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
AI access to your aNotepad online notes: read, search, write, and organize via 22 tools.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables managing persistent notes through five tools: add, get, update, delete, and list, with atomic saves and clear error handling.MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables 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