ThreadPage
Start writing
All docs

Connections

Connect coding agents, AI models, apps and automations to your notes. Each one has a name, its own access and a record of what it did.

On this page
  1. Ways to connect
  2. Agents in your workspace
  3. Choose access
  4. The Inbox
  5. Pause, change or disconnect
  6. Review and undo
  7. Files in notes
  8. For developers

Ways to connect

Ways to connect
KindUse it for
AppsChat apps like Claude and ChatGPT that read and add your notes.
Coding agentsClaude Code or Codex on your computer. @ one in a thread to give it work.
AI modelsClaude or GPT with your own API key. @ it in a thread and it answers with a note.
AutomationsBring updates in from other apps, and send notes you @ to your workflows.

Each connection has one name. A name with @, such as @Claude, is one you can write in a note to send it that note.

Only you can send a request, unless you let your agents ask each other. Anything else waits for your permission.

Free and Plus let apps, coding agents and scripts add notes to your Inbox, up to 3,000 a month. They can’t read your notes. Pro with Sync lets them read and work in your threads, and adds AI models and automations: Add notes from another app and Send notes you @ to a URL.

Agents in your workspace

Agents are your Claude Code and Codex sessions, the Claude and ChatGPT apps, and AI models on your keys. Automations run your workflows. Together they are your connections.

An agent works within the access you give it. Tell it how to work in Instructions and set Where it works.

  • Who can ask it: no one, only you, also your agents, or also your automations.
  • Requests from AI models is a separate setting for requests from models connected with an API key. Choose Ask first (the default), Allowed or Blocked.
  • Notes from people and scripts: only the ones you point to, or all of them, marked as theirs.

Put an agent’s full @Name at the start of a note or choose the agent from the @ picker to address it. A handle typed later stays in the note’s text.

When an agent goes beyond its settings, it waits for your permission: Allow once, Always allow… or Don't allow. On your phone you can allow once from the notification with Face ID or your fingerprint.

A chain is all the work that follows one note. It stops at 20 requests; Allow 20 more lets it go on. One summary shows under your note. Stop all there stops the whole chain, and each agent stays stopped in it until you ask it again.

In a shared place, each person can ask only their own agents, and only if the owner lets the people they invited use agents. Inside a shared place, only what the owner set there applies.

To stop: Stop on a request, Stop all under your note, Pause on a connection, Connections can work here in Agents… of a folder or thread, or Turn off all connections at the top of Connections.

Choose access

Apps, coding agents and scripts each have one of five levels. Can edit and organize reads, adds and edits notes, and organizes threads and folders, including Archive and Trash; it can’t delete permanently. Can add notes, an app’s default, reads and searches notes, adds notes, threads and reminders, and changes or moves to Trash only the notes it added. Can read reads and searches notes, including earlier versions, without changes. Add only adds notes to threads you choose and sees their titles, without reading notes. Add to Inbox only adds notes to your Inbox; it is the access Free and Plus have.

A URL that adds notes from another app stays on Add only for its one thread. A webhook you @ reads only the note you send it.

Access levels explains each one and what is never included.

The Inbox

With a free account, notes from connections arrive in the browser that collects them: the one where you created your first connection, or the one where you choose Collect here in Settings → Connections. Until then they wait for up to 30 days, then they are removed. If that browser stays closed for a week while notes wait, the next browser you open collects them.

Disconnecting a connection removes the notes it added that still wait for a browser to collect them. Replace token… keeps them.

The Inbox is an ordinary thread. Move it to Trash or delete it, and the next note starts a new Inbox; archive it, and the next note brings it back.

With Plus or Pro and Sync, notes from connections go straight to the Inbox in your account. Plus allows 3,000 notes a month; Pro has no monthly connection limit. When Pro ends, connections that can add notes add them to your Inbox again, without reconnecting.

Pause, change or disconnect

Open an app, coding agent, AI model or script in Settings → Connections and choose Manage access to narrow or widen what it can do. Widening asks you to confirm it’s you.

Pause stops a connection from reading and adding notes until you choose Resume. Notes you send it with @ meanwhile wait and reach it when you resume.

A token works for 30, 90 or 365 days, as you choose when you create it, and for up to 90 days on Can edit and organize. A token unused for 90 days stops working. Seven days before it stops, ThreadPage reminds you.

Renew keeps the same token working for a new term. Replace token… makes a new token and stops the old one at once. Disconnect… stops the connection and everything it uses at once.

Review and undo

Open a connection’s Recent activity to see what it read and changed, or Activity from a thread’s actions to review that thread.

A note an agent added is signed with its name, such as @api, and one it changed last reads Edited by @api. A note an app, a script or an incoming URL added shows Added via and its name; one it changed last shows Edited via and its name.

Recent activity of a connection lists what it did. Undo changes… undoes its changes over a period you choose, where nothing changed them since, and Restore from Trash… brings back what it moved to Trash. If something looks unusual, ThreadPage emails you once a day at most and the connection shows Check activity.

Files in notes

A level that reads notes also reads the files in them.

For developers

The developer reference is in English: Script or API, MCP server, Receive webhooks and Errors.

Open Connections