stickyrice-mcp

MCP (Model Context Protocol) server for Sticky Rice - interact with your notes from Claude.

Quick Start

1. Authenticate

npx stickyrice-mcp auth

This opens your browser to authorize the connection. Once approved, your credentials are saved locally.

2. Configure Claude

Add to your Claude config (~/.claude.json or Claude Desktop settings):

{
  "mcpServers": {
    "stickyrice": {
      "command": "npx",
      "args": ["-y", "stickyrice-mcp"]
    }
  }
}

3. Restart Claude

You're done! Ask Claude about your notes.

Commands

npx stickyrice-mcp auth     # Authenticate (opens browser)
npx stickyrice-mcp logout   # Remove saved credentials
npx stickyrice-mcp status   # Check authentication status
npx stickyrice-mcp help     # Show help

Available Tools

Workspaces

| Tool | Description | |------|-------------| | list_workspaces | List all your workspaces | | create_workspace | Create a new workspace | | update_workspace | Update workspace name or order | | delete_workspace | Delete a workspace (moves boards to Personal) |

Boards

| Tool | Description | |------|-------------| | list_boards | List all your boards | | get_board | Get a board with all columns, notes, and items | | create_board | Create a new board | | update_board | Update board title, order, or move to workspace | | delete_board | Delete a board and all its contents | | search_notes | Search notes by keyword across all boards |

Columns

| Tool | Description | |------|-------------| | create_column | Create a new column in a board | | update_column | Update column title, order, or move to another board | | delete_column | Delete a column and all its notes |

Notes

| Tool | Description | |------|-------------| | create_note | Create a new note in a column | | update_note | Update note title, color, or move to another column | | delete_note | Delete a note and all its items | | get_note | Get a single note with all details |

Note Items

| Tool | Description | |------|-------------| | add_note_item | Add a bullet journal item to a note | | update_note_item | Update item content or type (todo, doing, done, etc.) | | delete_note_item | Remove an item from a note |

Tags

| Tool | Description | |------|-------------| | list_tags | List all your tags | | create_tag | Create a new tag | | tag_note | Apply a tag to a note | | untag_note | Remove a tag from a note |

Available Resources

| Resource | Description | |----------|-------------| | stickyrice://boards | All boards | | stickyrice://board/{id} | Full board with notes | | stickyrice://note/{id} | Single note details | | stickyrice://tags | All tags | | stickyrice://todos | All incomplete todos |

Examples

Ask Claude things like:

Workspaces & Organization:

• "Create a new workspace called 'Projects'"
• "Show me all my workspaces"
• "Create a new board called 'Q1 Goals' in my Projects workspace"

Boards & Columns:

• "Show me all my boards"
• "Create a column called 'In Progress' in my Work board"
• "What's on my Growth Plan board?"

Notes & Items:

• "Create a new note in my Ideas column with title 'MCP Integration'"
• "Add a todo item 'Review PR' to my Tasks note"
• "Mark the first todo in my Tasks note as done"
• "Delete the Mobile App note from my Product column"

Search & Tags:

• "Search my notes for 'meeting'"
• "Tag my Project note with 'urgent'"

Manual Authentication

If you prefer not to use browser auth, you can set environment variables:

{
  "mcpServers": {
    "stickyrice": {
      "command": "npx",
      "args": ["-y", "stickyrice-mcp"],
      "env": {
        "CONVEX_URL": "https://glad-dragon-481.convex.cloud",
        "STICKYRICE_API_KEY": "sr_your_api_key"
      }
    }
  }
}

Get your API key from Sticky Rice Settings.

Requirements

• Node.js 18 or higher
• A Sticky Rice account
• Claude Desktop or Claude Code

License

MIT