Connect over OAuth
Point your assistant at your Takibi address plus /mcp, pick the profile it acts as, and disconnect it any time.
Connect your assistant
In ChatGPT or Claude, add a connector. If the setting is labeled MCP, use that. Paste this address:
https://app.takibibase.com/mcpThe assistant opens Takibi to sign in. Log in as usual, including the emailed code if you use two-factor, and you land on the connect screen.
Connect from Grok in the terminal
Add Takibi as a server in Grok's terminal app:
grok mcp add --transport http takibi https://app.takibibase.com/mcpThen tell it where to sign in. Open ~/.grok/config.toml, find the [mcp_servers.takibi] block, and add this line:
oauth_client_id = "https://app.takibibase.com/.well-known/oauth-client/grok"Open /mcps in Grok, choose the Takibi server, and sign in when the browser window opens. From there, pick the profile it acts as.
Connect from Cursor
Add Takibi as a remote MCP server in Cursor. In your mcp.json:
{
"mcpServers": {
"takibi-base": {
"url": "https://app.takibibase.com/mcp",
"auth": {
"CLIENT_ID": "https://app.takibibase.com/.well-known/oauth-client/cursor"
}
}
}
}The CLIENT_ID must be this exact address, typed out — a placeholder never signs in. Cursor opens Takibi to sign in; log in as usual, then pick the profile it acts as and choose Allow.
Pick the profile it acts as
The connection acts as one of your profiles, never as you. It reads only what that profile can read. Choose the profile on the connect screen. Each row names up to three collections and counts the folders and tags.
The profile needs document access and the ask or search capability. Profiles missing either, and paused profiles, stay dimmed and say why. If none of your profiles qualify, open Profiles in a new tab, set one up, then start the connection again from your assistant.
Check the app name and where it sends you back to before you choose Allow. If it sends you back to a program on your own computer, only allow it when you started the connection yourself, just now, from an app on that computer.
Know what it can do
The connector is read-only by default: it cannot change or delete anything in your workspace. It has five read tools:
| Tool | Meaning |
|---|---|
| Ask Takibi | Answers one question in a single collection, with the passages it used and how well they support the answer. |
| List Takibi collections | Names the collections and folders that profile can open. Tag-only access is left off this list. |
| Get Takibi document | Fetches the text of one document that profile can read. |
| Get Takibi task | Fetches one task that profile can read. |
| Show Takibi artifact | Reads one artifact body — Founder feedback, a deliverable — from a task that profile can read. |
Claim-capable connections add six task tools. All six need a grant carrying claim access; claiming, noting, moving, flagging, and attaching additionally need the profile's Connector writes toggle on:
| Tool | Meaning |
|---|---|
| Claim Takibi task | Claims one task for that profile under a 30-minute lease — one live claim at a time. |
| Add claim note | Files a short plain-text draft note under the live claim (3 notes per claim). Filing sends task.note_added to subscribed endpoints. |
| Release claim | Releases the live claim, freeing the task for others. |
| Update Takibi task status | Moves the held task between columns, with an optional review handoff note. Tasks in Review close in the app or CLI, never over MCP. |
| Set Takibi task blocked | Flags the held task as blocked — or clears it — with a reason, optionally until a time (wakeAt). |
| Add Takibi task artifact | Attaches a markdown deliverable or a link to the held task. |
Takibi reads that profile's access on every request, so narrowing it or pausing the profile applies to the next one. A question also stops once the profile has used its daily limit.
Disconnect an app
Open Settings → Security and find Connected apps. Each row names the app and the profile it acts as. Choose Disconnect to cut its access at once.
Connecting the same app again opens the connect screen with the last profile already selected. Choose Allow to use it, or pick a different profile.