Whim MCP Server

Connect any MCP-compatible AI assistant (Claude Code, etc.) to your Whim task lists.

Setup

1. Get your API key

Open Whim → Sidebar → ⚙ Settings → Generate API Key

2. Configure your MCP client

Add to your .mcp.json (Claude Code) or equivalent config:

{
  "mcpServers": {
    "whim": {
      "command": "npx",
      "args": ["-y", "whim-mcp"],
      "env": {
        "WHIM_API_KEY": "your-api-key-here"
      }
    }
  }
}

That's it — no install step needed. npx fetches and runs the package automatically.

Available tools

Items

| Tool | Description | |------|-------------| | whim_get_items | Get items in a specific list | | whim_get_all_items | Get all items across all lists (filter by space or status) | | whim_add_item | Add a task to a list | | whim_complete_item | Mark a task as done | | whim_update_item | Edit a task (text, due date, status) | | whim_delete_item | Remove a task |

Smart views

| Tool | Description | |------|-------------| | whim_get_today | Items due today or unscheduled (matches the app's Today view) | | whim_get_upcoming | Items with future due dates (matches the app's Upcoming view) |

Lists & spaces

| Tool | Description | |------|-------------| | whim_get_lists | Get all your lists (owned + shared) | | whim_get_spaces | Get all your spaces | | whim_create_list | Create a new list (optionally in a space) | | whim_rename_list | Rename a list | | whim_delete_list | Delete a list and all its items | | whim_clear_list | Delete all items in a list (keep the list) |