Sticky Note Mcp Server

by aynul-abedin

256 downloads
Not rated
GitHub

About

Sticky Note MCP Server is a minimal yet powerful implementation of the **Model Context Protocol (MCP)** built with **FastMCP** in Python.

Details

Author
aynul-abedin
Downloads
256
Categories
Knowledge Base, Productivity, Project Management

- Structured storage with automatic migration from legacy notes.txt.
- Tools for creating, listing, searching, updating, deleting, and bulk‑clearing notes.
- Optional tagging, pinned state, and archived flag per note.
- Resources exposing the latest note, pinned notes, and aggregate stats.
- Prompt templates for summarising notes or generating a roadmap by tag.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Sticky Note Mcp Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Activate your Python environment and launch the server with uv run mcp dev ./main.py. From an MCP-compatible client, point to the generated manifest or directly invoke the tools, resources, and prompts exposed by the server.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "sticky note mcp server": {
            "sticky-note": {
                "command": "uv",
                "args": [
                    "run",
                    "mcp",
                    "dev",
                    "./main.py"
                ],
                "env": {
                    "OPENAI_API_KEY": "<API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "sticky-note": {
        "command": "uv",
        "args": [
            "run",
            "mcp",
            "dev",
            "./main.py"
        ],
        "env": {
            "OPENAI_API_KEY": "<API_KEY>"
        }
    }
}

AI Sticky Notes MCP Server

This demo shows a richer Model Context Protocol server built with FastMCP. It turns a simple sticky-note list into a structured note system with tagging, pinning, archiving, and summarisation helpers.

Features

- Structured storage with automatic migration from the legacy notes.txt file. - Tools for creating, listing, searching, updating, deleting, and bulk-clearing notes. - Optional tagging, pinned state, and archived flag for each note. - Resources that expose the latest note, pinned notes, and aggregate stats. - Prompt templates for summarising notes or producing a roadmap for a specific tag.

What You Can Do With This MCP Server

This server lets you:
- Create notes with tags and pinned status for important items
- List and filter notes by tags, pinned status, or archived state
- Search through note content and tags to find specific information
- Update existing notes to change their content, tags, or status
- Delete individual notes or bulk-clear all/archived notes
- Pin important notes so they stand out in summaries
- Archive completed or outdated notes without losing them
- Generate summaries of your active notes using AI prompts
- Create roadmaps from tagged notes to plan projects or tasks
- Access stats showing total, active, archived, and pinned note counts
- Retrieve the latest note or all pinned notes via resources

Available MCP Interfaces

Tools

- add_note(message, tags=None, pinned=False) – Create a new note with optional tags (comma-separated) and pinned flag - read_notes(include_archived=False) – Get all notes sorted by creation date (newest first) - list_notes(limit=20, offset=0, tag=None, pinned_only=False, include_archived=False) – Paginated note listing with filtering - search_notes(query, include_archived=False) – Find notes containing the query text in message or tags - update_note(note_id, message=None, tags=None, pinned=None, archived=None) – Modify an existing note's content or metadata - delete_note(note_id) – Permanently remove a specific note - clear_notes(archived_only=False) – Delete all notes, or just archived ones

Each tool returns structured JSON so calling clients can display note metadata alongside the original message.

Resources

- notes://latest – most recent active note text. - notes://pinned – newline-delimited pinned notes with identifiers. - notes://stats – counts for total, active, archived, and pinned notes.

Prompts

- note_summary_prompt() – Asks the AI to summarize all active notes and highlights any pinned ones - note_roadmap_prompt(target_tag=None) – Asks the AI to turn matching notes into a prioritized roadmap (optionally filtered by tag)

Example Use Cases

1. Personal Task Management: Pin urgent tasks, tag by project, archive completed items
2. Brainstorming: Quickly capture ideas with tags, then use the roadmap prompt to organize them
3. Meeting Notes: Store discussion points with meeting tags, search later by keywords
4. Learning Tracker: Save learning resources or tips, organize by topic tags
5. Project Planning: Create notes for features or bugs, filter by tag, generate roadmaps
6. Daily Journaling: Quick thoughts throughout the day, summarize with AI at day's end

Running the Server

Activate your environment and launch the MCP server CLI:

uv run mcp dev ./main.py

From another MCP-compatible client, point to the generated manifest or directly invoke the tools/resources/prompts exposed by this server.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.