Notes

Provides access to stored notes via MCP commands: list_notes, get_note, and search.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks 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": {
    "rwelgosh-mcp-server-notes": {
      "command": "python",
      "args": [
        "notes.py"
      ]
    }
  }
}

You run a lightweight MCP server that exposes notes stored locally and lets clients list, retrieve, and search them using MCP commands. This makes it easy to integrate note data into your applications or tooling without building a custom API layer.

How to use

To interact with the MCP Notes Server, connect your MCP client to the local MCP endpoint and call the available commands. You can list all notes to get an overview, fetch a specific note by name, or perform a search across notes using a query. Each command returns structured data describing notes, categories, and sub-details, enabling you to filter and present information in your app or workflow.

How to install

Prerequisites: ensure you have Python 3.7 or newer installed on your system.

python -V

Create and activate a virtual environment to isolate dependencies.

python -m venv venv
source venv/bin/activate  # macOS/Linux
venv\Scripts\activate     # Windows

Install the required dependencies listed for the server.

pip install -r requirements.txt

Start the MCP Notes Server using the provided Python script.

python notes.py

Additional notes

Notes are stored as JSON files in the path ~/DocumentationGenerator/notes/. The server exposes three MCP commands to interact with these notes: list_notes, get_note, and search. The list_notes command returns all notes, get_note retrieves a note by its name, and search looks for notes matching a query string. Each note JSON contains a category, a summary, and a list of tags with detailed sub-messages.

Available tools

notes.list_notes

Retrieve the full list of notes stored in ~/DocumentationGenerator/notes and return their basic metadata.

notes.get_note

Fetch a single note by its name from the stored collection, returning the complete note JSON.

notes.search

Search notes by a query string, optionally narrowing to a specific note, and return matching results.