# Sticky Notes MCP

An MCP (Model Context Protocol) server that gives Claude full read and write access to Windows Sticky Notes. It works directly with the Sticky Notes database, so Claude can create, search, edit, and delete your notes during a conversation.

## Features

- Create, read, update, and delete notes
- Search notes by text
- Add or remove individual lines in a note
- Change note colors
- Control whether notes are open or always on top
- Safely closes and reopens the Sticky Notes app around every change to prevent data loss

## Requirements

- Windows 10 or Windows 11
- Microsoft Sticky Notes app
- Python 3.11 or later
- Claude Desktop

## Installation

1. Clone or download this repository.
2. Install the only dependency:

   pip install -r requirements.txt

3. Open your Claude Desktop config file at:

   %APPDATA%\Claude\claude_desktop_config.json

4. Add the server under "mcpServers":

   "sticky-notes": {
     "command": "python",
     "args": ["C:\\path\\to\\sticky_notes_mcp.py"]
   }

5. Restart Claude Desktop.

## Available Tools

| Tool | Description |
|------|-------------|
| list_notes | Lists all notes, with optional text search and result limit |
| get_note | Returns the full text of one note by ID |
| create_note | Creates a note with text, color, and visibility settings |
| update_note | Changes a note's text or visibility settings |
| delete_note | Permanently deletes a note by ID |
| append_to_note | Adds one or more lines to the end of a note |
| remove_line_from_note | Removes a specific line from a note by matching its text |
| inspect_schema | Shows the database structure for debugging |

## How It Works

Sticky Notes stores its data in a local SQLite database called plum.sqlite. Because the app can overwrite outside changes, this server closes Sticky Notes before every write and reopens it once the change is saved.

## Limitations

- Windows only
- Sticky Notes briefly closes and reopens whenever a note is changed
- Newer versions of the Sticky Notes app may store notes differently

## License

This project is licensed under the MIT License.