mcp-notes-server-dev
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-notes-server-devadd a note titled 'Groceries' with 'milk, eggs, bread'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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.
- TaprootOAuthcom.taproothq
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
- aNotepadOAuthcom.anotepad
AI access to your aNotepad online notes: read, search, write, and organize via 22 tools.
ADHD-friendly tasks, notes & projects for LucidNest - 18 tools, scoped tokens, Streamable HTTP.
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 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
- 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