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 titled Groceries with milk, eggs, and 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.
my-mcp-server
MCP server template I base new tools on
Examples
# 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/my-mcp-server/server.py"],
# "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
# }
# }
# }
python server.py --helpRelated MCP server: mcp-notes-server
What it does
Five tools: add / get / update / delete / list notes
A missing note raises instead of returning the string 'not found'
Notes path set by MCP_NOTES_FILE or --notes-file
Includes a Claude Desktop config snippet with absolute paths
Atomic saves (temp file + os.replace) behind a write lock
Every tool carries a real docstring, so clients get descriptions
Install
pip install -r requirements.txtProject structure
├── .github/
│ └── workflows/
│ └── ci.yml
├── docs/
│ ├── configuration.md
│ ├── development.md
│ └── usage.md
├── examples/
│ └── quickstart.md
├── tests/
│ └── test_notes.py
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── SECURITY.md
├── requirements.txt
└── server.pyDevelopment
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -qNotes
mostly stable, edge cases remain
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.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables adding, getting, and listing notes through MCP, with state persisted to a JSON file in the home directory.MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to create, retrieve, update, delete, and list notes through an MCP server, with persistent JSON storage and atomic writes.MIT
- 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 creating, retrieving, updating, deleting, and listing notes through a simple MCP interface, with configurable note storage.MIT