About Stickies
Stickies is a local MCP server for agents to manage sticky notes in a project’s `.canvas` file. Its JSON Canvas format works with Obsidian, and changes can be tracked with git while preserving unrelated file data.
Key features
- 01List notes and filter by state
- 02Add, edit, and delete notes
- 03Set note text, color, position, and state
- 04Use project-local JSON Canvas files
- 05Preserve edits and unrelated canvas data
Use cases
- 01Track agent tasks on a project board
- 02Review or update notes in Obsidian
- 03Keep note changes visible in git
MCP support
The server exposes note-listing and editing tools to MCP clients. It runs locally through stdio and can use a chosen `.canvas` or `.json` board within the project.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 4d ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| board | string | No | Which board. Leave out for the default. |
| limit | integer | No | At most this many notes. Default 100. |
| state | enum | No | Only notes in this state.open | progress | done |
Details
From the project README@getmurmur/stickies-mcp
An MCP server that lets agents leave, read and tick off sticky notes for you, in the open Stickies format.
Notes go in a stickies.canvas file in your project. A Stickies document is valid JSON Canvas, so the file opens in Obsidian as a board, git shows what changed, and the notes paste into any app that reads Stickies.
Install
Claude Code:
claude mcp add stickies -- npx -y @getmurmur/stickies-mcp
Codex, Cursor and other MCP clients:
{
"mcpServers": {
"stickies": { "command": "npx", "args": ["-y", "@getmurmur/stickies-mcp"] }
}
}
Needs Node 22 or later. It runs on your machine: no account, no server, nothing leaves your project.
Tools
| Tool | What it does |
|---|---|
list_notes | Reads the notes on a board, as a Stickies document. Filter by state. |
add_notes | Adds notes. Only text is needed; new notes are placed below the others. |
update_notes | Changes notes by ID: text, colour, position or state. state: "done" ticks one off. |
remove_notes | Deletes notes by ID, with any arrows to them. |
Every tool takes an optional board: another .canvas or .json file inside the project.
Options
| Option | Default | |
|---|---|---|
--file <path> | stickies.canvas | The default board, relative to the project. |
--root <dir> | the current folder | The project folder. Boards can't be outside it. |
--author <name> | the agent's app | Who new notes are by, when the agent doesn't say. Without it, they're signed with the name the agent's app reports, such as "Claude Code". |
How it treats your file
- It reads the file fresh on every call, so edits made in Obsidian or by hand are never overwritten.
- It keeps everything it doesn't change: other kinds of node, arrows, and other apps' data.
- It writes atomically, and leaves a file alone if it isn't valid JSON or valid Stickies.
- A plain JSON Canvas file from Obsidian works too. It becomes a Stickies document the first time a note is added.
MIT licensed. Part of Stickies, made by Murmur: a Mac app for thinking with Claude Code and Codex on a branching canvas.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.