mcp-notes-server-x
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-x
Learning MCP: tiny notes server with five tools
Started as a weekend hack, grew on me.
How to use
# 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-x/server.py"],
# "env": {"MCP_NOTES_FILE": "/abs/path/to/notes.json"}
# }
# }
# }
python server.py --helpRelated MCP server: sourcify-context-server
Install
pip install -r requirements.txtFeatures
A missing note raises instead of returning the string 'not found'
Every tool carries a real docstring, so clients get descriptions
Notes path set by MCP_NOTES_FILE or --notes-file
Five tools: add / get / update / delete / list notes
Atomic saves (temp file + os.replace) behind a write lock
Includes a Claude Desktop config snippet with absolute paths
Project structure
├── docs/
│ ├── development.md
│ ├── roadmap.md
│ └── usage.md
├── tests/
│ └── test_notes.py
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── SECURITY.md
├── requirements.txt
└── server.pyDevelopment
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -qWhy
Needed this for myself; figured others might too.
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
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
An MCP server that used to create notes
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Persistent memory layer for AI tools. Save and recall notes across Claude and other MCP clients.
Related MCP Servers
- AlicenseAqualityDmaintenanceA simple note-taking MCP server for recording and managing notes with AI models.429 npm37GPL 2.0
- AlicenseNot gradedqualityDmaintenanceA simple notes MCP server that enables creating, listing, and summarizing text notes via resources, tools, and prompts.MIT
- AlicenseAqualityCmaintenanceA lightweight MCP server for managing text notes with add, list, search, and delete operations, persisting notes as a JSON file.411 npmMIT
- 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