MCP Notes Server

Name: MCP Notes Server
Author: rwelgosh

@rwelgosh

Repository

About MCP Notes Server

No overview available yet

Basic information

Config

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

{
  "mcpServers": {
    "mcp-notes-server": {
      "type": "http",
      "url": "http://localhost:8000"
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Notes Server?

MCP Notes Server is a simple MCP (Message Coordination Protocol) server that provides programmatic access to notes stored in the ~/DocumentationGenerator/notes/ directory. It is intended for developers and applications that need to list, retrieve, and search note files via an HTTP MCP interface.

How to use MCP Notes Server?

To use it, set up a Python virtual environment (Python 3.7+), install dependencies with pip install -r requirements.txt, then start the server by running python notes.py. The server listens on http://0.0.0.0:8000. Clients connect via MCP client libraries and call commands such as list_notes(), get_note(note_name), and search(query, note_name=None).

Key features of MCP Notes Server

Exposes notes via MCP over HTTP on port 8000.
Supports three commands: list, get, and search notes.
Notes are stored as JSON files with category, tags, and messages.
Each message includes a timestamp and content.
Simple Python setup with a virtual environment and requirements file.

Use cases of MCP Notes Server

Programmatically browse a personal note collection from another application.
Search notes by query string to find relevant information quickly.
Retrieve individual notes by name for display or further processing.
Integrate note access into larger MCP-based workflows or automation.

FAQ from MCP Notes Server

What is the note structure supported by MCP Notes Server?

Notes are stored as JSON files with fields for category, summary, tags (each containing tag, summary, and messages with timestamp and message).

What are the available MCP commands?

The server provides three commands: list_notes(), get_note(note_name), and search(query, note_name=None).

What runtime dependencies are required?

You need Python 3.7+ and the packages listed in requirements.txt. A virtual environment is recommended.

Where are notes stored?

Notes are stored in the ~/DocumentationGenerator/notes/ directory as JSON files.

How does a client connect to the server?

Clients connect via MCP client libraries (e.g., MCPClient) to the HTTP endpoint at http://localhost:8000 and call the available commands.

Comments

More Memory & Knowledge MCP servers

Semantic Scholar MCP Server

YUZongmin

A FastMCP server implementation for the Semantic Scholar API, providing comprehensive access to academic paper data, author information, and citation networks.

158