AI Notes MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOTES_FILE | No | Path to the JSON file where notes are saved. Defaults to ~/.ai-notes-mcp/notes.json. | ~/.ai-notes-mcp/notes.json |
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
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| add_noteB | Save a new note to the user's knowledge base. Use tags to group notes by topic (for example 'python', 'exam', 'ideas'). |
| search_notesA | Find notes by keywords. Results are ranked by relevance (matches in the title count most, then tags, then content). |
| get_noteA | Read the full content of one note by its id. |
| list_notesA | List notes, newest first. Optionally only notes with a given tag. |
| update_noteA | Change the title, content or tags of an existing note. Only the fields you pass are changed. |
| delete_noteA | Permanently delete a note. Ask the user for confirmation before calling this. |
| knowledge_statsA | Overview of the knowledge base: number of notes, tags and most recent activity. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| summarize_notes | Ask the AI to summarize all notes, or only those with a tag. |
| study_quiz | Turn notes about a topic into quiz questions to test yourself. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| tag-index | All tags and how many notes use them |
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: add/get/update/delete a single note, list notes, search notes, and show aggregate stats. The boundary between list_notes and search_notes is resolved by descriptions (newest-first listing with optional tag filter vs keyword relevance search). No two tools appear to do the same thing.
Six of seven tools follow a predictable verb_noun pattern (get_note, list_notes, update_note, delete_note, add_note, search_notes). knowledge_stats is a noun_phrase deviation, but it is still readable and clearly scoped.
Seven tools is well-scoped for a notes/knowledge-base server. The set covers core operations plus search and stats without redundant or filler tools.
The surface provides full CRUD lifecycle coverage: add, read (get/list/search), update, and delete notes. Tag filtering, keyword search, and aggregate stats round out the expected workflows with no obvious dead ends.