mcp_notes
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_HTTP_HOST | No | Host for HTTP server. | 0.0.0.0 |
| MCP_HTTP_PATH | No | Path for MCP endpoint. | /mcp |
| MCP_HTTP_PORT | No | Port for HTTP server. | 8788 |
| NOTES_DATA_DIR | No | Directory for storing Markdown notes files. | ./data/notes |
| MCP_SERVER_TOKEN | No | Bearer token for HTTP endpoint. Required for HTTP mode. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| notes_saveB | Save a Markdown note/report into NOTES_DATA_DIR and return metadata plus the saved file resource. |
| notes_readA | Read a Markdown note by id or fileName from NOTES_DATA_DIR. |
| notes_listB | List recent Markdown notes from NOTES_DATA_DIR. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 3 tools
Each tool has a distinct, non-overlapping purpose: save, read, and list notes. There is no ambiguity about which tool to select for a given operation.
All tools follow the same 'notes_' prefix followed by a verb (save, read, list), creating a predictable and consistent naming pattern.
With 3 tools, the server is tightly scoped to basic note operations. Each tool earns its place, and the count is well-suited to a minimal notes management server.
The server covers create (save), read, and list, but notably lacks update and delete operations. For a notes management domain, these are significant missing pieces that may force workarounds.