Repository avatar
Other Tools
v0.1.1
active

stickies

io.github.getmurmur/stickies

Agents leave, read and tick off sticky notes in a .canvas file that opens in Obsidian.

Documentation

Stickies

https://stickies.live

An open format for moving sticky notes between apps: copy and paste, drag and drop, and agent tools (MCP).

Every Stickies document is also a valid JSON Canvas file. It adds a few fields JSON Canvas doesn't have: named colours, a note's state (open, in progress, done), author, and a link back to where the note came from.

Copied notes also go on the clipboard as HTML and plain text, so they paste properly into apps that don't support the format yet.

Use it

React components, from the registry:

npx shadcn@latest add https://stickies.live/r/sticky-board.json

The agent skill, for any agent:

npx skills add getmurmur/stickies

Or into a project's .claude/skills, from the registry:

npx shadcn@latest add https://stickies.live/r/stickies-skill.json

The MCP server, so an agent can leave, read and tick off notes in a stickies.canvas file in your project:

claude mcp add stickies -- npx -y @getmurmur/stickies-mcp

What's here

spec/              the spec, its JSON Schema, and example documents
skills/stickies/   an Agent Skill for making, checking and copying Stickies notes
apps/www/          stickies.live: the site, the docs, and the registry
  registry/        the registry's source: format library, theme, hooks, note, board and integrations
apps/tldraw-example/  tldraw with Stickies copy and paste, for trying the integration (development only)
packages/mcp/      the MCP server (@getmurmur/stickies-mcp)
packages/tests/    tests for the format library and the MCP server, and the install check

Working on it

A pnpm workspace. From the root:

  • pnpm dev: the site, on port 1450.
  • pnpm dev:tldraw: the tldraw example, on port 1452.
  • pnpm build: builds the registry, then the site.
  • pnpm registry: writes registry.json and the theme from apps/www/registry/stickies, then builds apps/www/public/r.
  • pnpm test: the format library's tests, which also check it agrees with the skill's script.
  • pnpm test:install: installs the registry into a brand-new Next.js and shadcn app and builds it. Slow; needs the network.
  • pnpm typecheck: every package.

Status: early draft, started by Murmur.

NPM
@getmurmur/stickies-mcp
Install Command
npm install @getmurmur/stickies-mcp