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 to remember to call mom"
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-kit
Learning MCP: tiny notes server with five tools
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-kit/server.py"],
# "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
# }
# }
# }
python server.py --helpRelated MCP server: notes-box
Install
pip install -r requirements.txtFeatures
Atomic saves (temp file + os.replace) behind a write lock
Includes a Claude Desktop config snippet with absolute paths
Notes path set by MCP_NOTES_FILE or --notes-file
Five tools: add / get / update / delete / list notes
Every tool carries a real docstring, so clients get descriptions
A missing note raises instead of returning the string 'not found'
Project structure
├── .github/
│ └── workflows/
│ └── ci.yml
├── docs/
│ ├── roadmap.md
│ └── usage.md
├── examples/
│ └── quickstart.md
├── tests/
│ └── test_notes.py
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── requirements.txt
└── server.pyDevelopment
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q说明
个人练习项目, 谨慎用于生产环境。
License
MIT licensed, see LICENSE.
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.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables adding, retrieving, and listing notes with state persisted to a local JSON file.-
- AlicenseNot gradedqualityCmaintenanceEnables adding, getting, and listing notes through MCP, with state persisted to a JSON file in the home directory.MIT
- FlicenseNot gradedqualityBmaintenanceEnables managing local Markdown notes by creating, viewing, listing, and searching notes and their contents through MCP tools.-
- AlicenseAqualityCmaintenanceEnables managing local Markdown notes and tasks through MCP tools to create, list, read, mark as done, and delete them.5MIT