Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NOTES_FILENoPath 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
summarize_notesAsk the AI to summarize all notes, or only those with a tag.
study_quizTurn notes about a topic into quiz questions to test yourself.

Resources

Contextual data attached and managed by the client

NameDescription
tag-indexAll tags and how many notes use them

TDQS

A4/5.0

Scored across 7 tools

Disambiguation5/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness5/5

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.

Maintenance

ActivityMaintained
ResponsivenessOutdated data