Wise Owl MCP server

Wise Owl MCP server

Wise Owl is a daily to-do list for software engineers: jot down the reviews, interruptions and small things of the day, and whatever you don't finish moves to tomorrow on its own. Its MCP server lets Claude, ChatGPT, Cursor, VS Code or any MCP client read and update your list. Ask in plain words: "what's still open this week?", "add the follow-ups from this PR for tomorrow", "plan my day".

https://api.wiseowl.cat/mcp

It's a remote server (Streamable HTTP): there's nothing to install or run. This repository holds only its documentation; the server itself isn't open source.

The setup for each assistant, in English, Catalan and Spanish, is also at wiseowl.cat/en/connect.

<!-- Demo GIF: an assistant planning the day with Wise Owl (about 20 seconds). Add it here, e.g. -->

You need an account

The assistant works with the list your Wise Owl account keeps in sync, so you need a free account: sign up at wiseowl.cat. Without an account, Wise Owl still works in your browser, but your list never leaves it, so no assistant can reach it.

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 and add it with the same address.

Claude (web and desktop)

1. In Claude, open Settings → Connectors and add a custom connector.
2. Paste Wise Owl's address: https://api.wiseowl.cat/mcp
3. 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:

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

Treat it like a password, and keep it out of files you commit. In the examples below, put your token in place of wopat….

Claude Code

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

When you create a token, Wise Owl shows this command with the token already in it.

Cursor

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

{
  "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:

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

Other MCP clients

Shortened. The full README is on GitHub.