Skip to main content
Glama
Notes MCP Server
by prem2230

Notes MCP Server

A simple MCP (Model Context Protocol) server for saving, listing, and searching notes. Built with the MCP SDK and persists notes to a local JSON file.


Setup

npm install

Related MCP server: tavily-server

Run the server

npm start

Connect to Claude Desktop

Edit your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/absolute/path/to/mcpServer/server.js"]
    }
  }
}

Restart Claude Desktop.


Available Tools

Tool

What it does

add_note

Save a new note with a title and content

list_notes

List all saved notes

search_notes

Search notes by keyword


Example prompts to use with Claude

Add a note titled "Meeting" with content "Discuss Q3 roadmap on Friday"

List all my notes

Search my notes for "roadmap"

Data storage

Notes are saved to ./notes.json — a plain JSON file you can open, edit, or back up any time.


Tech stack

  • MCP SDK @modelcontextprotocol/sdk

  • Zod for input validation

  • Node.js ESM ("type": "module")

Available Tools

3 tools
add_noteC

Save a new note

Inputs: title (required), content (required).

list_notesC

List all notes

Inputs: no named parameters.

search_notesC

Search notes by keyword

Inputs: query (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct action: adding, listing, and searching notes. No overlap in purpose.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case (add_note, list_notes, search_notes).

    Tool Count3/5

    Three tools is on the low side for a note-taking server, but it covers basic operations. Could be considered minimal but not extreme.

    Completeness2/5

    Missing update and delete operations, which are standard for notes. The tool surface is incomplete for full lifecycle management.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that implements a simple notes system with resources for notes, a tool to create notes, and prompts to summarize notes.
      1
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server for managing text notes, with resources (note:// URIs), tools (create_note), and prompts (summarize_notes).
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol (MCP) server that gives Claude a persistent personal notebook. Notes are stored on disk as JSON, so they survive restarts and are shared across every tool and resource.
      -