Connect toodoori to ChatGPT and Claude with MCP

This guide shows you how to connect toodoori to ChatGPT or Claude to review and organize your tasks in conversation. Both apps connect through the Model Context Protocol (MCP), a standard that lets AI apps use features of other services. Each app reads and changes your tasks only within the access you allow when you connect.

After connecting, you can ask ChatGPT or Claude things like:

“Show me tasks due this week”, “Create a ‘request review’ task in this project”, “Move my finished tasks to Done.”

For a worked example of proposing tasks, reviewing them, and saving only the ones you choose, read Turn AI Chat into Tasks: A Worked Example.

There are four ways to connect.

  • ChatGPT: add a custom MCP server, then sign in to toodoori and choose access.
  • claude.ai connector: add the connection address and sign in to toodoori. There’s nothing to install, so this option is easier for most people.
  • Claude Code: register the connection address with one command and sign in to toodoori in your browser. No token needed.
  • Personal access token (PAT): create a token and run the toodoori MCP server on your computer from Claude Code or the Claude desktop app. Use this option if you want to attach files from your computer by file path.

Connect with ChatGPT

What you need

  1. A toodoori account
  2. A ChatGPT account that allows you to add custom MCP servers

These steps were tested with ChatGPT Pro and developer mode enabled on October 11, 2026. Menus and access may differ by account or workspace. For the current requirements, see OpenAI’s ChatGPT connection guide.

Step 1: Add the server

  1. Open the ChatGPT plugins page, open the + or add menu, and select Add custom MCP server.
  2. Enter a name such as Toodoori and a description such as View and manage tasks in toodoori.
  3. Enter this public MCP server URL:
https://api.toodoori.com/mcp
  1. Choose OAuth as the authentication method and open OAuth configuration.

Step 2: Check the OAuth settings

  1. Keep the automatically discovered settings under Advanced OAuth settings. You do not need to enter a client ID or client secret manually.
  2. Keep read and write under Default scopes.
  3. Enter offline_access under Required scopes.
  4. Review the risk notice and select Create as a plugin to proceed.

Step 3: Sign in to toodoori and choose access

  1. Continue the connection from ChatGPT. On the toodoori page that opens, sign in if needed.
  2. Check that App shows ChatGPT, Returns to points to chatgpt.com, and Account is the toodoori account you want to connect. To change accounts, select Use a different account.
  3. Choose Read only to view tasks and retrospectives, or Read and write to also create, edit, move, archive, and delete tasks.
  4. Select Allow to return to ChatGPT and finish connecting.

If you don’t recognize the app or return address, select Deny. To change access later, disconnect the app in toodoori’s My Page and connect again from ChatGPT.

Step 4: Check the connection in a conversation

  1. On the plugin details page, select Try in chat. You can also open a new chat, type @, and select toodoori.
  2. Ask: “Show my toodoori projects.”
  3. Check that the returned projects match your toodoori account to confirm the connection works.

Connect with a claude.ai connector

What you need

  1. A toodoori account
  2. A Claude account. According to Anthropic, custom connectors are available on the Free, Pro, Max, Team, and Enterprise plans. The Free plan allows only one.

Step 1: Add the connector

  1. On claude.ai, open settings and go to Connectors.
  2. Choose to add a custom connector.
  3. Give it a recognizable name such as toodoori, and enter this connection address:
https://api.toodoori.com/mcp
  1. Select Connect on the connector you added.

On the Team and Enterprise plans, an admin adds the connector from the connectors page in organization settings. Menu names and locations may change as Claude updates its interface. For the latest steps, see Anthropic’s help article Get started with custom connectors using remote MCP.

You can also copy the connection address from the Integrations tab in toodoori’s My Page.

Step 2: Sign in to toodoori and choose access

When you select Connect, a toodoori page opens. If you aren’t signed in, sign in first and you’ll come back to the confirmation page. Check the following:

  • App: the app asking to connect. If you started from claude.ai, it shows claude.ai.
  • Account: the toodoori account to connect. To connect a different one, select Use a different account.
  • Returns to: where you’ll go after allowing the connection.
  • Access: choose one.
    • Read only: the app can view your tasks and retrospectives.
    • Read and write: in addition to viewing, the app can create, edit, move, archive, and delete tasks.

Select Allow to return to Claude and finish connecting. To change the access later, disconnect the app in My Page and connect again from Claude.

If you don’t recognize the app, or the return address isn’t what you expected, select Deny. The confirmation page also shows a warning in two cases: when the app registered itself, so its name can’t be verified, and when it returns to a program on this computer. Allow the connection only if you started it from that app yourself.

Step 3: Use it in a conversation

Open connectors from the + button at the bottom left of the message box and turn on toodoori. On the connectors page in Claude’s settings, you can choose for each tool whether Claude may use it right away or must ask for your approval each time. If tools that change tasks require approval, you can see what Claude is about to do and decide whether to allow it.

According to Anthropic, connectors added on claude.ai are also available in the Claude desktop and mobile apps signed in to the same account. We recommend signing in to toodoori from claude.ai on the web.

Connect from Claude Code

Claude Code can also connect to the same address without a token. Signing in and choosing access work the same way as with the claude.ai connector.

  1. In a terminal, register toodoori at user scope. It’s available in every project, and the config file stores only the address, not a token.
claude mcp add --transport http --scope user toodoori https://api.toodoori.com/mcp
  1. Start Claude Code, enter /mcp, choose toodoori from the list, and select Authenticate.
  2. The toodoori confirmation page opens in your browser. Check the account and access as in Step 2 of the claude.ai connector, then select Allow to return to Claude Code.

Because Claude Code returns to a program on this computer after you sign in, the confirmation page shows a warning. If you started the connection from /mcp yourself, it’s safe to allow it.

If you already registered toodoori with a personal access token, register the new one under a different name, or remove the old one first with claude mcp remove toodoori.

Review or disconnect

Under Connected AI apps in the Integrations tab of toodoori’s My Page, you can see each connected app, the access you chose, when you connected, and when it was last used. Select Disconnect and that app can no longer read or change your toodoori data. To use it again, connect again from ChatGPT, claude.ai, or Claude Code.

If the Integrations tab shows “New AI app connections are paused right now.” instead of the connection address, toodoori isn’t accepting new connections for the moment. You can still review and disconnect connected apps on the same page.

Connect with a personal access token

With this option, you run the MCP server (@peoplenexteam/toodoori-mcp) on your computer from Claude Code or the Claude desktop app. Use it when you want to attach files from your computer by file path. It authenticates with a personal access token (PAT), so every request goes through toodoori’s usual authentication and permission checks.

What you need

  1. A toodoori account and a personal access token
  2. Claude Code or the Claude desktop app
  3. Node.js (to run via npx)

Step 1: Generate a personal access token

  1. Sign in at toodoori.com.
  2. Go to the Access Tokens tab in My Page.
  3. Select Generate token, give it a name, choose only the access (scopes) you need, and set an expiration.
  4. Copy the generated token (tdr_pat_...).

The token is shown only once, right after it’s created. Store it somewhere safe, such as a secret manager.

Tasks, projects, sub-projects, stages, labels, user, retrospectives, and exports each have a read scope and a write scope. Choosing write also turns on read for the same item. If you only need to view, choose read only, and turn on write just for the items you want to create or change.

Step 2: Register it with Claude

Claude desktop app

Paste the following into claude_desktop_config.json and replace only tdr_pat_... with the token from Step 1 (leave the address as is).

{
  "mcpServers": {
    "toodoori": {
      "command": "npx",
      "args": ["-y", "@peoplenexteam/toodoori-mcp"],
      "env": {
        "TOODOORI_PAT": "tdr_pat_...",
        "TOODOORI_API_BASE": "https://api.toodoori.com"
      }
    }
  }
}

Save the file and restart the Claude desktop app. The toodoori tools will appear.

This config file lives in your personal folder (~/Library/Application Support/Claude/), so it isn’t part of any code repository. The token is stored there in plain text, though, so grant only the scopes you need, keep expirations short, and revoke the token if you suspect a leak.

Claude Code

To connect without a token, follow Connect from Claude Code above. To connect with a token, follow the steps below.

If you put the token directly into claude mcp add, the server works only in that project, and the token ends up in a file that could be committed to git by mistake. Instead, keep the token in a shell environment variable and register at user scope (--scope user). The server then works in every project, and the token isn’t written to any config file.

First, add the token to your shell profile (~/.zshrc or ~/.bashrc):

export TOODOORI_PAT="tdr_pat_..."
export TOODOORI_API_BASE="https://api.toodoori.com"

Open a new terminal or run source ~/.zshrc. Then register at user scope (without the token in the command):

claude mcp add --scope user toodoori -- npx -y @peoplenexteam/toodoori-mcp

The registration is saved in your home directory (~/.claude.json) and doesn’t contain the token. The MCP server inherits the environment variables above when it starts, so run claude from a terminal where they’re set.

When sharing a setup with a team, don’t use --scope project (the repository’s .mcp.json) with the token in it. Commit only a token-free config and have each person set the token in their own shell environment. Add any file that holds the token, such as .env, to .gitignore.

What can it do?

Within the access you allow, ChatGPT and Claude can:

  • View: projects, boards, stages, task search and details, labels, sub-projects, statistics, the archive, retrospectives, automation rules, and attachments
  • Organize tasks: create, edit, and move tasks (one or many), archive and restore, delete, change labels, and manage checklists, notes, relations, external links, and attachments
  • Configure: create labels, manage sub-projects and their notes, edit project briefs, and manage automation rules
  • Retrospectives and exports: write and edit retrospectives, export retrospectives and tasks as markdown, and manage export templates

Requests that change data are denied if you allowed read only, or if the token lacks the scope. A connected app can’t handle account deletion, billing and subscriptions, access tokens and connected apps, Spaces, or the Jira integration. Sign in to toodoori to do these yourself.

Conventions worth knowing

  • A due date is represented as expectedEnd.
  • Task content, retrospectives, and notes are exchanged as markdown strings.
  • Project and sub-project IDs are encoded strings. Don’t make them up; use the id returned by the list tools as is.
  • Errors come back as { error, code, status }, and the connected app uses the code to correct the request and try again.

Security notes

  • Disconnect apps and revoke tokens as soon as you stop using them.
  • Allow only the minimum access you need, and keep token expirations short.
  • Send a PAT in a header only. Never put it in a URL or a code repository.
  • If a token leaks, revoke or rotate it right away (rotating issues a new token and invalidates the old one immediately) from the Access Tokens tab in My Page.

Next steps

Once connected, ask ChatGPT or Claude to show tasks you want to review or organize. Tasks you create and move in conversation show up on your board and in your past work, just like the ones you handle yourself.

Your First Card Starts Here

Choose what to work on, then keep completed work and its stage history as a record.

Create Your First Card