Connect your AI assistant

Connect Wise Owl to Claude, ChatGPT or your coding agent and ask in plain words: “what's still open this week?”, “add the follow-ups from this PR for tomorrow”, “plan my day”. It reads your days on every board, adds tasks, ticks them off and moves them, under the same rules as the app.

Wise Owl's MCP server is at this address (Streamable HTTP). It's all Claude and ChatGPT need:

https://api.wiseowl.cat/mcp

You need a Wise Owl account: the assistant works with the list your account keeps in sync. Without one, your list never leaves your browser. Included with a free account. Sign up

What an assistant can do

These are the server's tools. They follow the same rules as the app: unfinished tasks carry over to today, and each board keeps its own days. The read tools cover every board unless the assistant names one.

Read

list_boards: your boards, and how many tasks are open on each today.
get_day: a day's tasks, with their status and how many times each was carried over. Opening today first brings over what's unfinished, as the app does. In Claude, the day shows up as a list you can tick right in the chat.
list_days: the tasks of a range of days, up to 31.
search_tasks: finds tasks by their text, and if you like by status or between two dates.
get_stale_tasks: the open tasks that keep being carried over: candidates to do now, break down or drop.
get_summary: how many tasks were done, carried over, dropped or left open in a period of up to 92 days, in total and per day.

Write

add_tasks: adds up to 50 tasks at once, for today or a later day, on the board you say.
set_status: marks a task done, open again, won't do, or for the next day.
edit_task: rewrites a task's text.
move_task: plans an open task for another day, like pushing it in the app.
delete_task: deletes a task from every day it's on. It's flagged as destructive, so a well-behaved assistant asks you first.

Prompts

plan_my_day: looks at today and the tasks that keep moving, and proposes a plan without changing anything until you say so.
weekly_review: reviews the last seven days: what you got done, what kept moving and what to change. It doesn't change any task.

Set it up

Claude and ChatGPT sign in with OAuth: they only need the address, and you log in to Wise Owl and allow them, with no keys to copy. For Claude Code, Cursor, VS Code, Windsurf and other clients, create an access token in Wise Owl and add it with the same address.

Claude (web and desktop)

In Claude, open Settings → Connectors and add a custom connector.
Paste Wise Owl's address: https://api.wiseowl.cat/mcp
Log in to Wise Owl and allow access. No keys to copy: it's OAuth.

The steps are the same in the Claude desktop app.

ChatGPT

ChatGPT connects with the same address: add a custom connector with it, then log in to Wise Owl and allow it.

Create an access token

Claude Code, Cursor, VS Code and Windsurf connect with a token:

Log in to Wise Owl and open User configuration → Connected assistants.
Write the assistant's name and click Create token.
Copy the token, which starts with wo_pat_, right away: it won't be shown again. It can read and change your tasks, and it expires after 90 days.

Claude Code

Run this in a terminal, with your token in place of wo_pat_…. When you create a token, Wise Owl shows this command with the token already in it.

claude mcp add --transport http wiseowl https://api.wiseowl.cat/mcp --header "Authorization: Bearer wo_pat_…"

Cursor

Add Wise Owl to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project, with your token:

{
  "mcpServers": {
    "wiseowl": {
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

VS Code

Add Wise Owl to .vscode/mcp.json in your project, or to your user configuration (MCP: Open User Configuration in the Command Palette). VS Code asks for the token when the server first starts, so it stays out of the file:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "wiseowl-token",
      "description": "Wise Owl access token",
      "password": true
    }
  ],
  "servers": {
    "wiseowl": {
      "type": "http",
      "url": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer ${input:wiseowl-token}" }
    }
  }
}

Windsurf

Windsurf, now called Devin Desktop, reads its MCP servers from mcp_config.json. Add Wise Owl there with your token:

{
  "mcpServers": {
    "wiseowl": {
      "serverUrl": "https://api.wiseowl.cat/mcp",
      "headers": { "Authorization": "Bearer wo_pat_…" }
    }
  }
}

Other MCP clients

Any client that supports Streamable HTTP can connect: give it the address and, if it can't sign in with OAuth, the header Authorization: Bearer wo_pat_… with your token.

Permissions

There are two permissions, or scopes:

tasks:read: read your tasks and days.
tasks:write: add, change, move and delete your tasks.

When you connect an assistant with OAuth, Wise Owl shows you what it asks for, and you allow or deny it. An access token has both.

Assistants can read and change tasks and nothing else: not your password, your account or your billing. Tokens expire, and you can revoke one or disconnect an assistant at any time.

Your settings list what each assistant added, rewrote, moved or deleted, with an Undo next to each change. Deleting is flagged as destructive, so a well-behaved agent asks you first.

An assistant sees the text of the tasks it reads, so connect only the ones you trust with it.

Revoke access

In Wise Owl, open User configuration → Connected assistants. Click Disconnect next to an assistant you connected with OAuth, or Revoke next to an access token. It stops working at once, and an assistant you disconnect has to ask you again to come back. Deleting your account revokes them all.

Removing Wise Owl from the assistant's settings doesn't revoke its access on its own: do it in Wise Owl too.