Notes

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

python

7

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "truaxki-mcp-notes": {
      "command": "mcp",
      "args": [
        "install",
        "src/notes"
      ]
    }
  }
}

You can run and manage the MCP Notes Server to store, retrieve, update, and delete notes with persistent JSON storage. It exposes note resources via a note:// URI scheme and can summarize notes with prompts, making it easy to integrate into your workflows and applications.

How to use

Start by installing and launching the server using the MCP CLI. Once running, you can create notes, list them, update existing notes, and delete notes using the built-in tools. Access notes as resources through the note:// scheme and request summaries when you need concise or detailed overviews of your stored content.

Typical workflow you can perform with the MCP client:

How to install

Prerequisites you need before installing the server:

Python 3.10 or later for manual installation
Node.js and npm for CLI-based installation (optional) if you choose to install via Smithery

Installation options you can choose from:

# Smithery installation (automatic for Claude Desktop)
npx -y @smithery/cli install notes --client claude

Additional setup and usage notes

Manual installation steps if you prefer a local Python environment:

python -m venv .venv

# On Unix/MacOS:
source .venv/bin/activate

# On Windows:
.venv\Scripts\activate

Install required Python packages:

pip install MCP

Notes on starting and operating the server

To begin using the MCP Notes Server, you interact with the MCP CLI to install and start the server. The following commands illustrate how to install the server source and then start it under MCP management.

{ "type": "stdio", "name": "notes_install", "command": "mcp", "args": ["install", "src/notes"] }

Prompts and note management features

Core note operations you can perform through the server tools include creating, reading, updating, and deleting notes. Each note stores the content along with creation and modification timestamps. You can also generate summaries of your notes using the built-in prompt generation capable of producing brief or detailed summaries.

Available tools

add-note

Create a new note with a unique name and content.

list-all-notes

Display all stored notes with their basic metadata.

update-note

Modify the content of an existing note by name.

delete-note

Remove a note by name.