notes-box
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., "@notes-boxadd a note: remember to call mom tomorrow"
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
A small MCP server exposing my notes to Claude Desktop
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/server.py"],
# "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
# }
# }
# }
python server.py --helpRelated MCP server: notes-box
Install
pip install -r requirements.txtHighlights
Atomic saves (temp file + os.replace) behind a write lock
Five tools: add / get / update / delete / list notes
Includes a Claude Desktop config snippet with absolute paths
Notes path set by MCP_NOTES_FILE or --notes-file
A missing note raises instead of returning the string 'not found'
Every tool carries a real docstring, so clients get descriptions
Project structure
├── docs/
│ └── roadmap.md
├── tests/
│ └── test_notes.py
├── .gitattributes
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── SECURITY.md
├── requirements.txt
└── server.pyDevelopment
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -qLicense
MIT licensed, see LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
Notes and actions in one app. Let Claude or ChatGPT read and update them.
- TaprootOAuthcom.taproothq
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Search, read, create and edit your Memol notes from Claude. Team note-taking with AI search.
Read and write your Fresh Jots notes from Claude, Cursor, and any MCP client.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to create, read, list, and manage local notes stored on the computer using natural language requests.1-
- FlicenseNot gradedqualityCmaintenanceEnables managing personal notes through Claude Desktop with add, get, update, delete, and list tools, using atomic saves and a configurable notes file.-
- FlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to add, retrieve, update, delete, and list personal notes persisted in a local JSON file, with atomic saves and configurable note storage paths.-
- 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