notes-box
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mcp-notes-server
Learning MCP: tiny notes server with five tools
Highlights
Notes path set by MCP_NOTES_FILE or --notes-file
Includes a Claude Desktop config snippet with absolute paths
A missing note raises instead of returning the string 'not found'
Five tools: add / get / update / delete / list notes
Atomic saves (temp file + os.replace) behind a write lock
Every tool carries a real docstring, so clients get descriptions
Related MCP server: notes-box
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 --helpGetting started
pip install -r requirements.txtProject structure
├── .github/
│ └── workflows/
│ └── ci.yml
├── docs/
│ ├── development.md
│ ├── faq.md
│ ├── roadmap.md
│ └── usage.md
├── tests/
│ └── test_notes.py
├── .editorconfig
├── .gitignore
├── CHANGELOG.md
├── 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 -qAcknowledgments
README structure inspired by popular OSS templates
Thanks to everyone opening issues with ideas
License
MIT - see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
AI access to your aNotepad online notes: read, search, write, and organize via 22 tools.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Notes, tasks, habits, journal and 6 more tools Claude can read and change, with undo. Free.
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to add, get, and list notes, with state persisted to a JSON file in the home directory.MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to add, get, and list notes, with state persisted to a JSON file in the home directory.MIT
- FlicenseNot gradedqualityCmaintenanceEnables managing personal notes through Claude Desktop with add, get, update, delete, and list tools, using atomic saves and a configurable notes file.-
- 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