MCP Notes Server

@truaxki

Repository

Basic information

About MCP Notes Server

A Model Context Protocol (MCP) server implementation providing persistent note management created with Python SDK.

#mcp-notes#note-management #python-sdk

MCP Notes Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-notes-truaxki": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "notes",
        "--client",
        "claude"
      ]
    }
  }
}

MCP Notes Server tools

Create a new note

Display all stored notes

Modify an existing note

Remove a note

Overview

What is MCP Notes Server?

MCP Notes Server is a Model Context Protocol (MCP) server implementation for managing notes with persistent storage. It provides create, read, update, and delete operations, timestamp tracking, note summarization via prompts, and resource-based access using a note:// URI scheme. It is intended for users who need note management integrated into an MCP client.

How to use MCP Notes Server?

Install automatically via Smithery (npx -y @smithery/cli install notes --client claude) or manually with Python 3.10+ and the MCP package. Start the server with mcp install src/notes and mcp start Notes, then call tools like add-note, list-all-notes, update-note, and delete-note from an MCP client.

Key features of MCP Notes Server

Create, read, update, and delete notes
Persistent JSON storage with timestamp tracking
Note summarization via LLM prompts
Resource access using the note:// URI scheme
Supports both brief and detailed summaries

Use cases of MCP Notes Server

Maintain a personal notebook accessible through any MCP client
Automate note-taking and retrieval in AI agent workflows
Summarize stored notes for quick review or model input
Access individual notes as resources using a consistent URI

Frequently asked questions

How are notes stored in MCP Notes Server?

Notes are stored in a local `notes_storage.json` file. Each note includes its content, creation timestamp, and last modification timestamp.

What tools does MCP Notes Server provide?

It provides four tools: `add-note` to create a note, `list-all-notes` to display all notes, `update-note` to modify an existing note, and `delete-note` to remove a note.

How can notes be accessed as resources?

Notes can be accessed using the `note://` URI scheme. Listing resources returns all available notes, and a specific note is read via `note://internal/note_name`.

What prompt generation feature is included?

The server includes a "summarize-notes" prompt that generates both brief and detailed summaries of notes, formatting them for language model input.

What are the dependencies for MCP Notes Server?

It requires Python 3.10 or later and the `MCP` Python package. The server uses no external database – persistence is handled by JSON file storage.

Comments

More Memory & Knowledge MCP servers

agentleFS

One permissioned folder your team and your AI agents both log into.

priostack

ideaswave

Open-source Python SDK & MCP interface for Priostack Agent Context Network (ACN). Zero-setup, autonomous memory orchestration for AI agents.

Groundwork

Rarefied-Earth

Groundwork: company memory for your AI tools. Docs public. Source closed. Public proof needs no account.

UmmahAPI

Yousuf Kazmi

Islamic source data for assistants: Quran, hadith, tafsir, duas, prayer times and qibla. Answers come from real sources with citations instead of recalled text, so verses and hadith are not hallucinated. 36,000+ hadiths

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226