Skip to main content
Glama
notes-box

notes-box

mcp-notes-server

A small MCP server exposing my notes to Claude Desktop

How to use

# claude_desktop_config.json
# {
#   "mcpServers": {
#     "notes-box": {"command": "python", "args": ["server.py"]}
#   }
# }
python server.py

Related MCP server: mcp-snippetbox

Install

pip install -r requirements.txt

What it does

  • State persisted to a JSON file in the home dir

  • Three tools: add / get / list notes

  • FastMCP style: decorators, zero boilerplate

  • Includes Claude Desktop config snippet

Project structure

├── docs/
│   ├── configuration.md
│   ├── development.md
│   ├── faq.md
│   ├── roadmap.md
│   └── usage.md
├── examples/
│   └── quickstart.md
├── tests/
│   └── test_smoke.py
├── .editorconfig
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── requirements.txt
└── server.py

Development

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

Known issues

  • none reported yet (surprisingly)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables adding, retrieving, and listing notes, with state persisted to a JSON file in the home directory.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude Desktop to manage personal notes stored in a JSON file, supporting add, get, update, delete, and list operations with atomic saves.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      -