Skip to content
Help topics · Connect your AI assistant

Connect your AI assistant

Plan, update, and unblock projects from the assistant you already use. It signs in as you, works only in your workspaces, and every change shows in the project’s history.

Updated

How it works

Unblockd has an MCP server at https://unblockd.ai/mcp. Your assistant connects to it with OAuth: you sign in to Unblockd in your own browser, and the assistant acts as you, in the workspaces you belong to. Every change it makes is recorded in the project’s history as yours, via your assistant. Your sponsor only ever sees what your team has shared.

Beside each in-app AI feature, choose Ask my assistant. If we have not seen your assistant connect, this opens setup. Otherwise it gives you a prompt to copy into your assistant, with the current workspace and relevant project, blocker, or update. Review the prompt before pasting. Your assistant does the reasoning on its own allowance; copying a prompt does not call Unblockd’s built-in AI. A previous connection may need reconnecting if access was revoked. In Command K, type your question and choose Ask my assistant before selecting the built-in answer.

On every plan, your assistant can also do the reading that built-in AI does on Basic, Team, and Business. It reads your sponsor’s emailed replies and records an answer when a confirmed sender clearly gives one; a reply with a condition, a question back, or a change request waits in Asks with its note. It checks the files your sponsor sends against what you asked for, suggests blockers your team flags in one tap, and calls each project’s risk, shown as assessed by your assistant. It runs on your own AI account.

In Unblockd, Your AI in the top bar has the same steps, with a copy button for each command.

For what an assistant can and can’t do, and how it compares with built-in AI, see Work with AI in Unblockd and every tool and what stays with you.

Guidance for your assistant

Unblockd tells your assistant how to do the work well. Its get_guidelines tool returns short playbooks: finish a task, produce a document and attach it, decide whether a blocker is the sponsor’s or your team’s, ask well, and write updates. The same playbooks are available as resources, as three prompts (complete_task, deliver_document, triage_blockers), and as two skills your assistant can install. To save calls, finish_task attaches the evidence, sets the status, and sets the next action in one step, flag_blocker can prepare the sponsor’s question with the blocker, and list_blockers, get_blocker, get_workspace, and read_evidence_file read what the app shows on the Blockers tab, in Settings, and in a task’s evidence.

Documents are attached as real files (up to 3 MB in one call, and up to 25 MB when the assistant uploads in two steps: it asks for a short-lived upload address, sends the file there, then confirms) or as links, never pasted into comments. A link to a file in Google Drive, Dropbox, OneDrive, Box, Notion, iCloud, or WeTransfer works as well as an upload, as long as the people who need it can open it without signing in: view-only sharing for anyone with the link, never editable, and your assistant asks you before opening up anything confidential. If an assistant pastes a long document into a comment or an evidence note, Unblockd still saves it and tells the assistant to attach a file instead. A blocker that only your team can clear stays with your team; one that needs your sponsor becomes a prepared ask that you share.

Emails your assistant adds

An email address your assistant adds for someone on your sponsor’s side is unconfirmed. Until a person on your team presses Confirm email on that person’s row in the project’s People tab, nothing is emailed to it: no update, digest, ask, reminder, or link, even if an automation is on. That includes an address it reads from a ticket or a comment, so text it was handed can’t start mail to a stranger. The assistant can see that an email is unconfirmed but has no way to confirm it. An address you add yourself is confirmed.

Progress tracking and scheduled reports

Ask your assistant to check source catch-up, pending mappings, refresh errors, or the weekly digest’s local schedule. It can inspect list_linked_sources and list_automations and run an authorized sync_source. A workspace admin enables tracking and automatic sending in the app. See Automatic progress and weekly digests for the steps and coverage checks.

The short version

  1. Add the Unblockd MCP serverIn your assistant’s settings, add a remote MCP server (some apps call it a connector) with the URL https://unblockd.ai/mcp.
  2. Sign inWhen the assistant asks, sign in to Unblockd in your own browser. Never paste a password or code into a chat.
  3. Try itAsk it what needs your attention today. A working connection answers from your projects, and asking changes nothing.

Claude

  1. In Claude, open Settings, then Connectors, and add a custom connector.
  2. Paste this URL, name it Unblockd, then connect and sign in.https://unblockd.ai/mcp

ChatGPT

  1. In ChatGPT, open Settings, then Apps & Connectors, and create a connector. If Create isn’t there, turn on Developer mode under Advanced.
  2. Paste this URL, choose OAuth, then connect and sign in.https://unblockd.ai/mcp

Claude Code

  1. Add Unblockd in your terminal.claude mcp add --transport http unblockd https://unblockd.ai/mcp
  2. Then run this inside Claude Code, choose unblockd, and sign in./mcp

Codex

  1. Run this in your terminal. It adds Unblockd, then opens your browser to sign in.codex mcp add unblockd --url https://unblockd.ai/mcp && codex mcp login unblockd

Cursor

  1. Open Unblockd in Cursor, approve the install, then sign in when Cursor asks.
  2. Or add it by hand in Cursor Settings, under MCP, with this URL.https://unblockd.ai/mcp

Any other assistant

  1. In your assistant’s settings, add a remote MCP server. Some apps call it a connector, an integration, or a tool.
  2. Paste this URL, name it Unblockd, and choose OAuth if it asks how to sign in. Then sign in to Unblockd.https://unblockd.ai/mcp
  3. If the app uses a config file instead, add this. Some apps name the keys differently.{"mcpServers":{"unblockd":{"url":"https://unblockd.ai/mcp"}}}

Check it works, and disconnect

Ask “What needs my attention today?” or “Give me today’s summary for each project.” A working connection answers from your projects. If the tools are missing, check the server is turned on for that conversation, then reconnect.

To disconnect, remove Unblockd from your assistant’s connector settings. The full reference for assistants is at setup.md, and how they work day to day is at skill.md.

Connect your assistant now

Your AI in Unblockd has the same steps, with a copy button for each command and the assistants already connected.