mcp-notes-server-x
Click on "Deploy 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., "@mcp-notes-server-x@mcp-notes-server-x add a note to buy groceries"
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.
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.
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.
- TaprootOAuthcom.taproothq
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.423 npm36GPL 2.0
- FlicenseNot gradedqualityDmaintenanceA simple notes MCP server that enables creating, listing, and summarizing text notes via resources, tools, and prompts.-
- AlicenseAqualityAmaintenanceA lightweight MCP server for managing text notes with add, list, search, and delete operations, persisting notes as a JSON file.42 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