mcp-notes-server
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
A small MCP server exposing my notes to Claude Desktop
Started as a weekend hack, grew on me.
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
A missing note raises instead of returning the string 'not found'
Notes path set by MCP_NOTES_FILE or --notes-file
Five tools: add / get / update / delete / list notes
Related MCP server: mcp-snippetbox
Installation
pip install -r requirements.txtUsage
# 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 --helpProject structure
├── .github/
│ ├── workflows/
│ │ └── ci.yml
│ └── pull_request_template.md
├── docs/
│ ├── development.md
│ ├── roadmap.md
│ └── usage.md
├── examples/
│ └── quickstart.md
├── tests/
│ └── test_notes.py
├── .gitignore
├── CHANGELOG.md
├── LICENSE
├── requirements.txt
└── server.pyFAQ
Is this production ready?
It works for my use case; review the code before relying on it.
Why no framework?
The stdlib covers what this project needs.
License
MIT. Do whatever you want.
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.
Notes and memory assistant: one Markdown vault that Claude, ChatGPT and any MCP client can share.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Related MCP Servers
- 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 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.-