MCP Notes Server

Name: MCP Notes Server
Author: truaxki

@truaxki

Repository

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

Basic information

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"
      ]
    }
  }
}

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

FAQ from MCP Notes Server

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.