notes-box
Click on "Install 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: buy groceries"
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
Learning MCP: tiny notes server with five tools
Side project, maintained when I have time.
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 --helpHighlights
Atomic saves (temp file + os.replace) behind a write lock
Notes path set by MCP_NOTES_FILE or --notes-file
Five tools: add / get / update / delete / list notes
Includes a Claude Desktop config snippet with absolute paths
A missing note raises instead of returning the string 'not found'
Every tool carries a real docstring, so clients get descriptions
Installation
pip install -r requirements.txtProject structure
├── docs/
│ ├── 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 -qChangelog
0.1.1- fix edge case in argument parsing0.1.0- first working version
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
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.
Read and write your Caliu notes from any MCP client: search, create, tag, remind, attach files.
1