mcp-notes-server-app
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-app
A small MCP server exposing my notes to Claude Desktop
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/mcp-notes-server-app/server.py"],
# "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
# }
# }
# }
python server.py --helpRelated MCP server: mcp-snippetbox
Highlights
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
Five tools: add / get / update / delete / list notes
Notes path set by MCP_NOTES_FILE or --notes-file
A missing note raises instead of returning the string 'not found'
Installation
pip install -r requirements.txtProject structure
├── .github/
│ └── workflows/
│ └── ci.yml
├── docs/
│ └── usage.md
├── tests/
│ └── test_notes.py
├── .gitignore
├── 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 -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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
MCP-native notes and memory for ChatGPT, Claude, and other AI tools.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to add, get, and list notes, with state persisted to a JSON file in the home directory.MIT
- AlicenseNot gradedqualityCmaintenanceEnables managing notes through a simple MCP server, providing tools to add, retrieve, update, delete, and list notes for use with Claude Desktop.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude Desktop to manage personal notes stored in a JSON file, supporting add, get, update, delete, and list operations with atomic saves.MIT
- 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.-