Skip to main content
Glama

mcp-notes-server-app

MCP server template I base new tools on

Built for my own use; public in case it helps someone.

Usage

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

Installation

pip install -r requirements.txt

Features

  • Three tools: add / get / list notes

  • State persisted to a JSON file in the home dir

  • FastMCP style: decorators, zero boilerplate

  • Includes Claude Desktop config snippet

Project structure

├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   └── bug_report.md
│   └── pull_request_template.md
├── docs/
│   ├── configuration.md
│   ├── development.md
│   ├── faq.md
│   └── usage.md
├── tests/
│   └── test_smoke.py
├── .editorconfig
├── .gitattributes
├── .gitignore
├── CHANGELOG.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── LICENSE
├── Makefile
├── SECURITY.md
├── requirements.txt
└── server.py

Development

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

Development

# run the test suite
pytest -q   # or npm test / go test ./...

License

MIT licensed, see LICENSE.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/dtmhed1255/mcp-notes-server-app'

If you have feedback or need assistance with the MCP directory API, please join our Discord server