Skip to main content
Glama
Ioniq3423

notes-box

by Ioniq3423

mcp-notes-server

A small MCP server exposing my notes to Claude Desktop

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 --help

Related MCP server: notes-box

Install

pip install -r requirements.txt

Highlights

  • Atomic saves (temp file + os.replace) behind a write lock

  • Five tools: add / get / update / delete / list notes

  • Includes a Claude Desktop config snippet with absolute paths

  • Notes path set by MCP_NOTES_FILE or --notes-file

  • A missing note raises instead of returning the string 'not found'

  • Every tool carries a real docstring, so clients get descriptions

Project structure

├── docs/
│   └── roadmap.md
├── tests/
│   └── test_notes.py
├── .gitattributes
├── .gitignore
├── CONTRIBUTING.md
├── LICENSE
├── SECURITY.md
├── requirements.txt
└── server.py

Development

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pytest -q

License

MIT licensed, see LICENSE.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables Claude Desktop to add, get, and list notes, with state persisted to a JSON file in the home directory.
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Enables a shared persistent knowledge vault for Claude Desktop, allowing notes to be saved, retrieved, searched, updated, and deleted across Chat and Code tabs.
    5
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables managing personal notes through Claude Desktop with add, get, update, delete, and list tools, using atomic saves and a configurable notes file.
    -