How does an AI agent connect to Decknote?

In ChatGPT, Claude or Claude Code, add https://decknote.app/mcp as a connector, then log in to Decknote and allow it. Or create an API token in Settings and point any MCP client at https://decknote.app/api/v1/mcp with an Authorization: Bearer header.

What can the agent do?

17 tools: list and create boards, add lists, and create, read, search, update, move, complete, reopen, archive and comment on tasks, and set reminders. Everything is scoped to boards the token can access, with the same permissions as the REST API.

Is the board only for the agent?

No — it's the same real-time board your team uses. The human sees cards appear live, drags them and closes them, and the agent sees those changes back.

ChatGPT · Claude · Claude Code · Cursor · any MCP client

Use your boards from ChatGPT, Claude and your AI agents

Paste one address in your AI app, log in to Decknote and allow it. From then on it can read your cards, add tasks, complete them and search back through what you noted — on the same boards your team sees live.

The address to connect:

https://decknote.app/mcp

See how to connect Create a free account

Connect it in a minute

Same idea everywhere: add a connector with the address, log in to Decknote and click Allow. No token to copy.

ChatGPT

1.Open Settings → Apps & Connectors (or Connectors) → Advanced, and turn on Developer mode.
2.Back in Apps & Connectors, click Create. Name it Decknote, paste the address above and choose OAuth.
3.A Decknote window opens: log in and click Allow.
4.In a chat, open the + menu, turn Decknote on and ask.

Custom connectors need a paid ChatGPT plan; in Business, Enterprise and Edu workspaces an admin may have to enable them first.

Claude

1.Open Settings → Connectors (Customize → Connectors in some versions).
2.Click Add custom connector, name it Decknote and paste the address above.
3.Click Connect, log in to Decknote and click Allow.
4.In a chat, turn Decknote on from the tools menu.

Works on claude.ai and the desktop app. Free accounts can add one custom connector; on Team and Enterprise an owner adds it for the organization and each member connects their own account.

Claude Code

1.Run this in your terminal:
claude mcp add --transport http decknote https://decknote.app/mcp
2.In Claude Code type /mcp, pick decknote and choose Authenticate. Your browser opens: log in and click Allow.

Cursor

1.Add this to ~/.cursor/mcp.json (or Settings → MCP → Add new server):

{
  "mcpServers": {
    "decknote": {
      "url": "https://decknote.app/mcp"
    }
  }
}

2.Next to decknote, click Login: log in and click Allow.

VS Code

1.Add this to .vscode/mcp.json (or run MCP: Add Server from the command palette):

{
  "servers": {
    "decknote": {
      "type": "http",
      "url": "https://decknote.app/mcp"
    }
  }
}

2.Start the server: VS Code asks you to log in to Decknote and allow it.

Any other client

1.Add the address as a remote MCP server (Streamable HTTP). Clients with OAuth ask you to log in by themselves; for the rest, use an API token (below).

Once connected, the app shows up in Settings → Connected apps, where you can disconnect it.

Then just ask

In plain words, in any language. A few things people ask:

“What's due this week across my boards?”
“Read the card “Launch plan” and summarize its open questions and comments.”
“Add “Call the supplier” to To do on the Office board, due Friday.”
“What did we finish last week?”
“Create a board for our trip, with lists for Ideas, Bookings and Packing.”
“Remind me about “Pay rent” the day before at 9:00.”

You stay in control

✓It sees what you see: the boards you own or were invited to, with your same permissions — it reads where you're a viewer and edits where you're an editor.
✓It works with boards, lists and cards. It can't change your plan or your password, delete a board or your account, or reach anyone else's boards.
✓Disconnect it whenever you want in Settings → Connected apps: it loses access right away.
✓Lookups are marked as read-only, so ChatGPT doesn't ask you to confirm every search.

17 tools, one board

Each is scoped to the boards your token can access, with the same permissions as the REST API — reads on any board you belong to, writes where you're an editor.

list_boards

Discover boards and lists — the ids the other tools need.

create_board

Start a board, optionally from a template.

create_list

Add a list (column) to a board.

search_tasks

Recall: find tasks by text, status and due date.

get_task

Read one task in full.

create_task

Add a task to a list.

update_task

Edit title, description or due date.

complete_task

Mark a task done.

reopen_task

Reopen a completed task.

move_task

Move a task to another list.

archive_task

Clean up: archive a task (it can be restored).

add_comment

Leave a progress note a human will read.

add_reminder

Get a push and an email about a task at a set time.

list_reminders

See your upcoming reminders.

remove_reminder

Delete a reminder.

search

Search the cards of every board — how ChatGPT looks things up.

fetch

Read one card in full: description, checklists and comments.

For scripts and servers: an API token

When there's no person to log in — a script, a server, an agent running on its own — use a token instead.

1. Create an API token in Settings → API Tokens (Free includes one).
2. Point your MCP client at /api/v1/mcp with the token as a Bearer header, like this config.
3. Ask your agent to add a task. Watch it land on the board, live.

Full reference in the API docs →

{
  "mcpServers": {
    "decknote": {
      "type": "http",
      "url": "https://decknote.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer ntrl_…"
      }
    }
  }
}

If something doesn't work

ChatGPT doesn't show Create or Developer mode: Custom connectors need a paid plan and Developer mode turned on. In a work account, an admin may need to allow them.
The app says it can't connect: Check that the address is exactly https://decknote.app/mcp — not /api/v1/mcp, which is for API tokens — and connect again.
It doesn't find one of my boards: It only sees boards you own or were invited to, and archived boards and cards are left out.
Does it work on the free plan?: Yes. Connecting an app works on every plan, and the plan's usual limits apply.

What it is, and isn't

The agent works with tasks, not your whole account — it can't change your plan, delete a board, or reach a board you don't have access to. And the board isn't an agent-only silo: it's the same real-time board your team already uses. That's what makes it a shared memory instead of a second inbox.

Start free