Use Kairo from ChatGPT, Claude or Gemini

Give an assistant its own key and it can plan your day, capture what you say and tick things off, without you opening Kairo.

On this page

What this is

Kairo can be connected to an AI assistant, so the planner lives wherever you are already typing. You say plan my day and it reads what is on today, what carried over and how full the day already looks. You say I finished the launch post and it ticks it off. You say remind me to call the bank at four and the reminder is set.

It works through MCP, an open standard that ChatGPT, Claude, Gemini, Grok and most coding assistants now speak. Kairo's address is https://kairo.jaimansoni.com/mcp.

Create a key

  1. 1Open Settings and go to Connections.
  2. 2Tap Connect, then New connection.
  3. 3Name it after where it will live, ChatGPT on my laptop, so you know which one to revoke later.
  4. 4Choose whether it may change things or only read.
  5. 5Copy the key. It is shown once and never again, because Kairo stores only a fingerprint of it.

Point your assistant at it

Wherever your assistant asks for a custom connector or an MCP server, give it the address and the key.

AssistantWhere to put it
ClaudeSettings → Connectors → Add custom connector. Address https://kairo.jaimansoni.com/mcp, header Authorization: Bearer YOUR_KEY.
ChatGPTSettings → Connectors → Create. If it accepts only a URL, use the link Kairo shows you with the key already in it.
Gemini CLI, Grok, othersAdd an HTTP MCP server at the same address with the header Authorization: Bearer YOUR_KEY. An X-API-Key header works too.
Claude Codeclaude mcp add --transport http kairo https://kairo.jaimansoni.com/mcp --header "Authorization: Bearer YOUR_KEY"

What it can do

Everything you can do in the app: capture, plan, complete, reschedule, break work into steps, run the morning sweep, set reminders, make and share lists, assign work inside a shared list, and read back the Log.

  • "Plan my day" reads today, what carried over, what is due soon and what capacity is left, then proposes a plan.
  • "I did the gym and the invoice" finds both and completes them, advancing anything that repeats.
  • "What carried over?" offers the same five choices the morning sweep does, including letting something go.
  • "What did I get done this week?" reads the Log.
  • Left running on its own, it can say what it is doing and stop to ask you something, wherever you are.

Watching it work, from your phone

An assistant with a key can also be *given* a task and left to it — a coding agent on your laptop, a script, anything that holds a key. The point of this is what happens after you walk away from the machine: what it is doing, and what it needs from you, come with you.

While something is working, the task wears a live chip and Today grows a small section at the top: one line per task saying what is happening. When it finishes its part, that line becomes what it did. Finishing is not ticking off — the task stays yours to check and complete.

When it reaches something it can't decide alone, it stops and asks. The question is pushed to your phone, sits at the top of Today under *An agent needs you*, and you answer in a sentence. It picks your answer up and carries on. This is the part that matters: an agent that asked a question two hours ago has been sitting idle for two hours.

  • report_progress — one line on what it's doing, and finished: true when its part is over.
  • ask_user — stop, ask one question, push it to your phone.
  • get_answer — pick your answer up once you've given it.
  • list_agent_work — everything being worked on, for picking up where a previous run left off.

What stays private

PIN-locked lists are invisible to a connection by default, including every task filed inside one. A key carries no PIN, so it gets nothing the PIN was protecting.

If you do want an assistant to see them, there is a checkbox when you create the key, off unless you tick it. You can create one key that can see them and another that cannot.

  • A read only key can never add, change or delete anything, and the tools to do so are not even offered to the assistant.
  • Your notes are out of reach unless you tick Include notes when creating the key: an assistant can search and read them, make new pages and add to existing ones, but never delete or rewrite a page.
  • Your habits work the same way, with Include habits: an assistant can see your habits and streaks, mark a habit done when you say you did it, and start a new one. It can't archive, delete or edit a habit, and it never sees who's on a leaderboard.
  • Giving a key locked lists takes a browser where they're unlocked.
  • A connection can only reach what you can reach: your own work, plus lists and tasks shared with you.
  • Nothing about your billing, your PIN or your sign-in is exposed.

Revoking and keeping track

Connections lists every key with its last four characters and when it was last used, so an unfamiliar one is easy to spot. Revoke kills it immediately.

  • You can hold up to 10 live keys at once.
  • Revoking cannot be undone, create a new key and paste it in again.
  • Deleting your Kairo account deletes every key with it.

If it will not connect

  • Unauthorized, or the assistant says the server rejected it — the key is wrong, was revoked, or has a stray space. Create a fresh one.
  • Payment required — the Kairo account's access has ended. Connections stop when the app does.
  • Wrong dates — the key remembers the time zone of the browser that made it. If you have moved, make a new key from where you now are.
  • Too many calls — an assistant stuck in a loop will be slowed down for a minute. Start a new chat.
Was this page helpful?