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?

209 tools: everything you can do in the app — boards, lists, cards, checklists, comments, labels, custom fields, rules, templates, attachments, sharing, notifications, settings, projects with their time, estimates, clients and reports, invoices and estimates, the client portal, workload, notes and time imports. It acts with your permissions and plan limits, anything that deletes, emails other people or publishes asks you first, and it can't move money: a payment is only written down.

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.

MCP-first · Claude · ChatGPT · Cursor · VS Code · any MCP client

Use your boards from Claude, ChatGPT 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.

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, the desktop app and the iPhone and Android apps (add it on the web or desktop; it then shows up on your phone). 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.

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 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

Add to Cursor

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

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

2.Next to decknote, click Login. Your browser opens: log in to Decknote, click Allow and let it open Cursor again.

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.Or from a terminal:
code --add-mcp '{"name":"decknote","type":"http","url":"https://decknote.app/mcp"}'
3.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:

“Show me my Launch board — you can drag cards right there in the chat, and it updates live.”
“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

A connected app acts as you, inside the limits you already have — and a few more.

It sees what you see

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.

Reading and changing are apart

Every tool says whether it only reads or changes something. Lookups run without asking; Claude and ChatGPT ask you before a tool that changes your boards.

A preview before anything big

Deleting for good, emailing other people, sharing a board or publishing a link first returns a preview of what would happen, and only takes effect after you confirm.

It can't move money

No tool charges, refunds or pays anything. Upgrading to Pro only gives you a Stripe link that you open and pay yourself, and managing the subscription is a Stripe link too.

Some things stay yours

It can't change your password, create tokens, delete your account or reach anyone else's boards.

Disconnect anytime

Disconnect it whenever you want in Settings → Connected apps: it loses access right away.

What data goes where

Your AI app gets an access token after you click Allow — never your password. Decknote stores tokens only as hashes; an access token lasts an hour and the app renews it until you disconnect it.
When you ask something, the app calls a Decknote tool and receives what that tool returns — the boards, cards or comments it asked for. From there it's part of your conversation, handled under that AI provider's privacy terms.
Decknote never sees your chats: only the requests the app makes. We keep the app's name and when it was connected and last used, and what it changes appears in the board's activity marked “via MCP”.

Read the AI agents section of our privacy policy →

209 tools, one board

Everything you can do in the app, grouped. Each tool works on the boards you can access, with your same permissions — reads on any board you belong to, writes where you're an editor.

reads only reads; runs without askingasks first shows a preview and waits for your OK

Start, search and readWhat needs attention, and finding any card.5 tools

overviewreads
Start here: your plan, recent boards, what needs attention and what to do next.
searchreads
Search the cards of every board — how ChatGPT looks things up.
fetchreads
Read one card in full: description, checklists and comments.
search_tasksreads
Recall: find tasks by text, status and due date.
list_my_tasksreads
Your tasks across every board, by due date.

BoardsOpen, create, organize and import boards.11 tools

list_boardsreads
Discover boards and lists — the ids the other tools need.
get_boardreads
Open a board: lists, cards, labels, members, fields and rules.
list_activityreads
See who did what on a board.
create_board
Start a board, optionally from a template.
update_board
Rename a board or change its icon, color or background.
set_board_preferences
Star a board or mute its notifications, just for you.
duplicate_board
Copy a whole board into a new one.
archive_board
Archive a board (it can be restored).
restore_board
Bring back an archived board.
delete_boardasks first
Delete a board for good — only after you confirm.
import_trello_board
Import a board from a Trello export.

ListsColumns, their order and their limits.5 tools

create_list
Add a list (column) to a board.
update_list
Rename or reorder a list, or set its WIP limit.
duplicate_list
Copy a list with its cards.
sort_list
Sort a list by due date, title or creation.
delete_listasks first
Delete a list and its cards, after you confirm.

TasksEverything on a card: dates, labels, people, links and templates.20 tools

get_taskreads
Read one task in full, with the ids of its checklists, comments and attachments.
create_task
Add a task to a list.
update_task
Edit title, description, dates, repeat or cover.
complete_task
Mark a task done.
reopen_task
Reopen a completed task.
move_task
Move a task to another list or another board.
archive_task
Clean up: archive a task (it can be restored).
restore_task
Bring back an archived task.
duplicate_task
Copy a task.
delete_taskasks first
Delete a task for good, after you confirm.
set_task_labels
Add or remove labels on a task.
set_task_assigneesasks first
Assign people to a task — they're notified once you confirm.
watch_task
Follow a task's comments, or stop.
set_task_field
Fill in a custom field on a task.
link_tasks
Mark that one task blocks or relates to another.
unlink_tasks
Remove a link between tasks.
bulk_tasks
Move, label or archive many tasks at once.
create_task_from_template
Add a task from a card template.
save_task_as_template
Save a task as a reusable template.
delete_card_templateasks first
Delete a card template, after you confirm.

Comments, checklists and attachmentsThe conversation and the work inside a card.13 tools

add_commentasks first
Leave a progress note a human will read.
edit_comment
Edit a comment.
delete_commentasks first
Delete a comment, after you confirm.
react_to_comment
React to a comment with an emoji.
add_checklist
Add a checklist with its items.
update_checklist
Rename or reorder a checklist.
delete_checklistasks first
Delete a checklist, after you confirm.
add_checklist_items
Add items to a checklist.
update_checklist_item
Check off or edit a checklist item.
delete_checklist_itemasks first
Delete a checklist item, after you confirm.
add_attachment
Attach a link or a file to a task.
rename_attachment
Rename an attachment.
delete_attachmentasks first
Delete an attachment, after you confirm.

Labels, fields, views and rulesHow a board is set up.11 tools

create_label
Add a label to a board.
update_label
Rename or recolor a label.
delete_labelasks first
Delete a label, after you confirm.
create_custom_field
Add a custom field: text, number, options, checkbox or date.
update_custom_fieldasks first
Rename a custom field or change its options.
delete_custom_fieldasks first
Delete a custom field, after you confirm.
create_saved_view
Save a personal view with its filters.
delete_saved_viewasks first
Delete one of your saved views.
create_automation
Add a board rule: when this happens, do that.
set_automation_enabled
Turn a rule on or off.
delete_automationasks first
Delete a rule, after you confirm.

People and sharingMembers, invitations, public links and embeds.9 tools

share_boardasks first
Share a board by email — only after you confirm.
update_member
Make a member an editor or a viewer.
remove_memberasks first
Take someone off a board, after you confirm.
leave_boardasks first
Leave a board someone shared with you.
transfer_boardasks first
Hand a board to another member.
set_public_linkasks first
Turn the public read-only link on or off.
list_embedsreads
See where a board is embedded.
create_embedasks first
Embed a board in another app of yours.
revoke_embedasks first
Turn off an embedded board.

Reminders and notificationsWhat's coming up and what's new.5 tools

add_reminder
Get a push and an email about a task at a set time.
list_remindersreads
See your upcoming reminders.
remove_reminder
Delete a reminder.
list_notificationsreads
Your mentions, assignments and comments.
mark_notifications_read
Mark notifications as read.

Projects, time and clientsTrack hours, set estimates and budgets, and report by client.30 tools

start_timer
Start the timer on a project or a task.
stop_timer
Stop it and keep the time.
get_running_timerreads
See what you are tracking right now.
log_time
Add hours by hand: "1h30" on a task, for a day.
list_time_entriesreads
A project's time log: who logged what, and when.
update_time_entry
Correct the duration, day, note or task of an entry.
delete_time_entryasks first
Delete an entry, after you confirm.
set_task_estimate
Say how long a task should take.
set_task_billable
Mark a task's time as billable or not.
get_task_timereads
A task's estimate against what has been tracked.
list_clientsreads
Your clients, with currency and default rate.
create_client
Add a client.
update_client
Change a client's details or rate.
archive_clientasks first
Archive a client, after you confirm.
restore_client
Bring an archived client back.
get_project_settingsreads
A project's client, status, budget, rate and dates.
update_project_settings
Change them: only the project owner can.
get_project_summaryreads
Time, billable amount and how much of the budget is used.
get_week_timesheetreads
Your week: hours per project, task and day.
get_time_reportreads
Add up time by project, client, person, task or day.
export_time_reportreads
The same detail as a CSV file (Pro).
get_time_rulesreads
See which hours are closed and how far back people can fix theirs.
set_time_rulesasks first
Close hours up to a day and set the edit window (Pro), after you confirm.
get_timer_alertreads
See when a forgotten timer alerts you.
set_timer_alert
Choose after how many hours a running timer alerts you, or turn it off.
list_timesheetsreads
The weeks of hours handed in for approval: yours, and the ones your people submitted to you.
submit_timesheetasks first
Submit your week to the owners of the projects you worked on, after you confirm (their hours close while it waits).
withdraw_timesheet
Take back a week that is still waiting for approval.
approve_timesheetasks first
Approve a week someone on your projects submitted, after you confirm (Pro).
reject_timesheetasks first
Send a week back, or reopen an approved one, with a note, after you confirm.

Invoices, estimates and expensesBookkeeping for your clients. Nothing here charges or moves money.36 tools

get_billing_profilereads
Your billing details: business name, prefixes, tax and payment terms.
update_billing_profileasks first
Set or change those details.
list_expensesreads
A project's expenses, and which are already invoiced.
create_expense
Log a cost on a project (nothing is paid).
update_expense
Correct an expense that is not invoiced yet.
delete_expenseasks first
Delete an expense, after you confirm.
add_expense_receipt
Attach the receipt of an expense: a photo or a PDF.
delete_expense_receiptasks first
Delete a receipt of an expense, after you confirm.
list_invoicesreads
Your invoices and estimates, with what is paid and what is owed.
get_invoicereads
One document in full: lines, totals, payments and its public link.
get_invoice_pdfreads
A document as a PDF file: the sheet its client gets.
get_receivables_agingreads
Who owes what, and for how long.
export_invoices_csvreads
Invoices and estimates as a CSV file for your accountant (Pro).
get_billing_reportreads
Invoiced, collected, expenses and profit per project.
create_invoice
Start a draft invoice or estimate. Nothing is sent.
list_unbilled_workreads
The hours and expenses of a project that are still unbilled.
preview_invoice_from_workreads
See the invoice that work would make, without creating it.
create_invoice_from_workasks first
Make a draft from the unbilled work — after you confirm the total.
update_invoice
Edit a draft (or the notes and due date of a sent document).
send_invoiceasks first
Publish a draft's link — after you confirm the total. Nothing is emailed.
get_invoice_email_draftreads
Read the email that would go to the client.
email_invoiceasks first
Email it to the client — after you confirm the exact email and the total.
regenerate_invoice_linkasks first
Replace a document's public link, after you confirm.
revoke_invoice_linkasks first
Turn a document's public link off, after you confirm.
void_invoiceasks first
Void a document and free its hours, after you confirm.
delete_invoice_draftasks first
Delete a draft that was never sent, after you confirm.
list_recurring_invoicesreads
List the invoices that repeat, with their next date.
create_recurring_invoiceasks first
Make an invoice repeat every week, month or year — after you confirm.
update_recurring_invoiceasks first
Change, pause or resume a recurring invoice.
delete_recurring_invoiceasks first
Stop a recurring invoice, after you confirm.
record_invoice_paymentasks first
Write down that the client paid — after you confirm. It does not charge or move money.
remove_invoice_paymentasks first
Delete a recorded payment, after you confirm.
duplicate_invoice
Copy a document into a new draft.
convert_estimate_to_invoice
Turn an accepted estimate into a draft invoice.
convert_estimate_to_project
Turn an accepted estimate into a project: its budget and one task per line.
record_estimate_answerasks first
Record that the client accepted or declined an estimate, after you confirm.

Client portalA page for your client: tasks, hours and documents. You decide what it shows.8 tools

get_client_portalreads
The portal's link, settings and the latest client comments.
update_client_portalasks first
Turn it on or off and choose what it shows — after you confirm what goes public.
regenerate_client_portal_linkasks first
Replace the portal's link, after you confirm.
set_task_visible_to_clientasks first
Show a task on the portal, after you confirm.
get_task_portalreads
A task's conversation with the client.
reply_to_clientasks first
Answer the client on the portal — after you confirm the exact text.
mark_client_comments_read
Mark the client's comments as read.
delete_client_commentasks first
Remove a comment from the portal, after you confirm.

Workload, templates, notes and filesPlan the team's weeks, start projects from a template and keep notes next to the work.28 tools

list_projectsreads
Every project with its client, status, hours and budget.
create_project
Start a project, optionally for a client.
get_workloadreads
Who has how much work each week, against their capacity (Pro).
list_team_ratesreads
See your team with what each person is billed at and what an hour of theirs costs you (Pro).
set_team_rate
Set a person's default rate and cost per hour (Pro).
get_member_ratesreads
See what each person on a project is billed at, and why (Pro).
set_member_rate
Set a person's rate on one project (Pro).
reprice_timeasks first
Give the hours already logged today's rates and costs, after a confirmation (Pro).
get_profitability_reportreads
What the hours were worth, cost and left, by project, client, person or task (Pro).
get_utilization_reportreads
How much of what each person could work went to billable hours (Pro).
get_assignments_reportreads
Who is doing what: every open task by person, with its estimate against the time logged (Pro).
set_my_weekly_capacity
Say how many hours a week you can work.
list_project_templatesreads
The starter and saved templates a project can begin from.
save_project_as_template
Save a project's shape as a template.
create_project_from_template
Start a project from a template.
rename_project_template
Rename a saved template.
delete_project_templateasks first
Delete a saved template, after you confirm.
list_pagesreads
A project's notes or discussions.
get_pagereads
Read a note or discussion with its comments.
create_page
Start a note or a discussion.
update_page
Edit a page; a save made on top of someone else's is refused.
set_page_pinned
Pin a page to the top (project owner).
set_page_archived
Archive a page or bring it back (project owner).
delete_pageasks first
Delete a page with its comments, after you confirm.
add_page_comment
Comment on a page.
edit_page_comment
Edit your own page comment.
delete_page_commentasks first
Delete a page comment, after you confirm.
list_project_filesreads
Every file and link attached to a project's tasks.

Holidays and time offMark the days nobody works and who is away, so each week's capacity is the real one.9 tools

list_holidaysreads
Your holidays (Pro).
add_holiday
Add a holiday: that day comes off everybody's capacity (Pro).
remove_holidayasks first
Remove a holiday, after you confirm (Pro).
list_time_offreads
Time off: yours and, with Pro, your team's, with the requests waiting for approval.
add_time_off
Record a vacation, sick leave or other time off, for you or for someone on your projects (Pro).
update_time_off
Change a time off.
remove_time_offasks first
Remove a time off, after you confirm.
approve_time_offasks first
Approve a time off someone on your projects asked for, after you confirm (Pro).
reject_time_offasks first
Reject a time off, with a note for the person, after you confirm (Pro).

Importing hoursBring your time from Toggl, Harvest, Clockify or any CSV, and undo it.6 tools

preview_time_importreads
See what a CSV would import, without writing anything.
import_time_csvasks first
Import it — after you confirm the preview.
list_time_importsreads
Your past imports.
undo_time_importasks first
Take an import back, after you confirm.
create_sample_project
Create a labelled sample project to see reports with data.
delete_sample_projectasks first
Delete the sample project, after you confirm.

Account and planSettings, access and your data. Billing only as Stripe links.11 tools

get_accountreads
Your settings, plan, limits, tokens and connected apps.
update_account
Change your name, language, time zone or notifications.
revoke_accessasks first
Revoke a token or disconnect an app, after you confirm.
list_webhooksreads
Your webhooks and Slack channels, and how their last delivery went.
create_webhookasks first
Send your boards' events to Slack or another app, after you confirm.
update_webhookasks first
Change a webhook's events, turn it on or off, or replace its secret.
delete_webhookasks first
Delete a webhook, after you confirm.
test_webhookasks first
Send a test to a webhook, after you confirm.
export_datareads
Export everything as JSON.
start_pro_checkoutasks first
Upgrade to Pro: you see the price, confirm it and pay on Stripe yourself.
open_billing_portal
Manage or cancel your subscription on Stripe.

Decknote's APIReading and creating through the same HTTP API as the app.2 tools

api_readreads
Read anything else through Decknote's own API (never logins or tokens).
api_createasks first
Create through Decknote's own API, after you confirm.

Prompts for a quick start: daily review, capture tasks and board cleanup. Full reference for every tool in the API docs.

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.
Cursor or VS Code opens the browser but never finishes: After you click Allow, the browser asks to open the app again: accept it. If the app was closed, open it and click Login (Cursor) or start the server (VS Code) once more.
It doesn't find one of my boards: It only sees boards you own or were invited to. Archived boards and cards only show up when you ask for them.
Does it work on the free plan?: Yes. Connecting an app works on every plan, and the plan's usual limits apply.

Still stuck, or want a client we don't list?

Write to us: a person reads every email and answers.

sales@devcloudsoftware.com

What it is, and isn't

The agent works with your same permissions — it can't reach a board you don't have access to, anything that deletes, emails people or publishes waits for your OK, and it can't move money. 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