notes.com
notes.com logo

Notes

Provides a simple interface for reading and writing notes, enabling quick information capture and basic note management...

Created byApr 23, 2025

MCP Notes Server

[![smithery badge](https://smithery.ai/badge/notes)](https://smithery.ai/server/notes)
A Model Context Protocol (MCP) server implementation for managing notes with persistent storage.
<a href="https://glama.ai/mcp/servers/tg4ugmp8jr"><img width="380" height="200" src="https://glama.ai/mcp/servers/tg4ugmp8jr/badge" alt="Notes Server MCP server" /></a>

Features

  • Create, read, update, and delete notes
  • Persistent storage using JSON
  • Timestamp tracking for creation and modifications
  • Note summarization via prompts
  • Resource-based access using note:// URI scheme

Installation

Installing via Smithery

To install notes for Claude Desktop automatically via [Smithery](https://smithery.ai/server/notes):

Manual Installation

  1. Ensure you have Python 3.10 or later installed
  1. Create a virtual environment: ```bash python -m venv .venv # On Unix/MacOS: source .venv/bin/activate # On Windows: .venv\Scripts\activate ```
  1. Install requirements: ```bash pip install MCP ```

Project Structure

Available Tools

  • `add-note`: Create a new note
  • `list-all-notes`: Display all stored notes
  • `update-note`: Modify an existing note
  • `delete-note`: Remove a note

Usage

  1. Start the server: ```bash mcp install src/notes mcp start Notes ```
  1. Example operations: ```python # Create a note await client.call_tool("add-note", { "name": "example", "content": "This is a test note" }) # List all notes await client.call_tool("list-all-notes") # Update a note await client.call_tool("update-note", { "name": "example", "content": "Updated content" }) # Delete a note await client.call_tool("delete-note", { "name": "example" }) ```

Storage

Notes are stored in `notes_storage.json` with the following structure:

Resource Access

Notes can be accessed as resources using the `note://` URI scheme:
  • List resources: Returns all available notes as resources
  • Read resource: Access a specific note using `note://internal/note_name`

Prompt Generation

The server includes a prompt generation feature for note summarization:
  • Supports both brief and detailed summaries
  • Formats notes for language model input
  • Available via the "summarize-notes" prompt

Development

To modify or extend the server:
  1. Clone the repository
  1. Install development dependencies
  1. Make changes in the appropriate module
  1. Test thoroughly before deploying

Testing

Tests should cover:
  • Basic CRUD operations
  • Multiple note handling
  • Error cases
  • Resource access
  • Prompt generation

License

[Add your license here]