Integrations / ChatGPT
ChatGPT MCP: use Atoll as your ChatGPT project management app
Add the hosted Atoll MCP server at https://atollhq.com/mcp to ChatGPT as a custom MCP server and sign in with OAuth. There is nothing to install. ChatGPT works as an Atoll agent you choose: it reads the heartbeat, finds assigned issues, updates the board and comments with the decisions you make in chat. Write actions need your confirmation by default.
OpenAI documentation checked .
What you get
Plan in ChatGPT. Keep the record in Atoll.
Its own seat
ChatGPT acts as an agent profile you approve, with its own permissions, so the board shows what the agent did and what you did.
Context from the board
The heartbeat, assigned issues, goals and KPIs come from Atoll, so a conversation starts from current work instead of a pasted summary.
Decisions on the issue
Plans, summaries and status changes land on the issue your team already tracks, not in a chat history only you can see.
Setup / custom MCP server
Add Atoll to ChatGPT as a custom MCP server
ChatGPT connects to remote MCP servers over HTTPS, so you don’t install a package, skill or CLI. You add Atoll’s hosted server yourself on ChatGPT web. In the current Plugins experience you don’t need to turn on Developer Mode first.
- Open Plugins in ChatGPT on the web.
- Select the plus button, then Add custom MCP server.
- Enter a name and, optionally, a description. Under Connection, enter the server URL. Under authentication, choose OAuth:
ChatGPT / Add custom MCP server fields
Name: Atoll
Description: Atoll issues, goals and heartbeat for my team
Server URL: https://atollhq.com/mcp
Authentication: OAuth- Review the risk warning, select I understand and want to continue, then Create as a plugin.
- ChatGPT sends you to Atoll to sign in. On the Atoll consent page, select or create the agent profiles this connection may use, then approve.
- Review the Atoll tools ChatGPT discovered, install the plugin and start a new conversation.
- Type
@in the prompt box, select the plugin and ask it to list your agent profiles:
ChatGPT / first prompt
@Atoll List the Atoll agent profiles this connection can use.
If there is more than one, ask me which one to use.You don’t enter a client ID, secret or API key. ChatGPT reads Atoll’s OAuth metadata at https://atollhq.com/.well-known/oauth-protected-resource and registers itself with Atoll’s authorization server. That server issues refresh tokens (offline_access), which OpenAI recommends so ChatGPT can keep the connection without asking you to sign in again. The hosted endpoint rejects sk_atoll_ API keys, so don’t choose No authentication or paste a key.
Reconnect and refresh
If Atoll finds an older, incomplete approval for the connection, it resets it instead of returning to ChatGPT automatically. Return to ChatGPT and connect again; in the legacy Apps flow, run Scan Tools again. The new request lets you choose the agent profiles again. When Atoll adds or changes tools, select Refresh on the plugin’s page in ChatGPT and start a new conversation. In a Business or Enterprise/Edu workspace, ChatGPT keeps the tool list an admin approved until an admin refreshes it.
Share it with your workspace
On Business, only workspace admins and owners can create and publish custom MCP server plugins. On Enterprise/Edu, admins can grant the Create plugins with MCPs permission to selected members, control access with RBAC and turn individual actions on or off. Once an admin publishes the plugin, members find it under Settings → Plugins and sign in to Atoll themselves, so each person authorizes their own agent profiles.
You add Atoll as a custom server with its URL. You don’t need to find it in OpenAI’s plugin directory, which OpenAI reserves for plugins published publicly after review.
Plans and limits
Which ChatGPT plans can read and write Atoll
- Business and Enterprise/Edu: custom MCP server connections with full MCP support, including write actions, on ChatGPT web.
- Pro: custom MCP servers with read and fetch permissions only. ChatGPT can read the heartbeat and issues, but cannot comment, create issues or move them.
- Other plans: OpenAI’s help article does not list custom MCP connections for them.
- Mobile: you can’t connect custom MCP servers in the mobile apps; OpenAI lists this as web only.
Atoll marks its read tools with the readOnlyHint annotation. ChatGPT treats every other tool as a write action and asks you to confirm it, based on the plugin’s permissions and the action’s context. You can approve for the rest of a conversation; a new conversation asks again. Deep research can use custom apps for read and fetch actions only.
Capabilities
What ChatGPT can do in Atoll
Read context
Heartbeat, assigned issues, goals, KPIs, initiatives and project workflows, so ChatGPT starts from what matters instead of a pasted summary.
Plan and triage
Turn a conversation into issues, split work into sub-issues and subtasks, and add labels and dependencies.
Update the board
Move issues across board columns and assign them to people or agents in the workspace. Write actions need your confirmation by default.
Report decisions
Comment with plans, decisions and summaries. Comments and status changes carry the agent’s name.
Update metrics
Record KPI snapshots when a human has granted that agent access to the KPI.
Stay in scope
Every call is checked against the agent’s organization, project and KPI grants. Anything outside them is refused.
The MCP server documentation lists every tool in Atoll’s public plugin profile.
Agent workflow
The heartbeat and what-next loop
| Step | What the agent does | MCP tool | Example prompt |
|---|---|---|---|
| Choose the agent | List the agent profiles you approved for this connection and pick the one ChatGPT should act as in this conversation. | atoll_list_agent_profiles | “List my Atoll agent profiles.” |
| Orient | Read the heartbeat: direct attention, grouped signals such as stalled or overdue work, and a recommended next action backed by goals and KPIs. | atoll_get_heartbeat | “Read my Atoll heartbeat and summarize what needs attention.” |
| Choose the next issue | List the issues assigned to the agent. For a parent issue split into sub-issues, read the next open, unblocked child in priority order. Reading it does not claim it. | atoll_list_issues, atoll_next_child | “Show my open Atoll issues by priority.” |
| Read the issue | Read the description, acceptance criteria and comments before planning or drafting anything. | atoll_get_issue, atoll_list_comments | “Open AP-123 and its comments.” |
| Update the board | Create issues, or move an issue to a status that exists on its board. Write actions need your confirmation by default. | atoll_create_issue, atoll_update_issue | “Move AP-123 to in progress.” |
| Report | Post the plan, decision or summary as a comment. It is attributed to the agent member, not to you. | atoll_add_comment | “Comment on AP-123 with the plan we agreed.” |
| Link delivery | Attach a GitHub pull request URL you share in the chat. The repository must be connected to Atoll. Put other links, such as documents, in a comment. | atoll_link_external_reference | “Link this PR to AP-123: <pr-url>” |
| Check again | Read the heartbeat again in a later conversation, or when the team asks what changed, rather than listing everything each time. | atoll_get_heartbeat | “What changed on my Atoll heartbeat?” |
Atoll does not start a ChatGPT conversation when an issue is assigned. Assignment adds the issue to the agent’s queue; ChatGPT reads it the next time you ask it to check Atoll.
Before ChatGPT can link GitHub pull requests, an Atoll owner or admin must connect the repository under Settings → Integrations → GitHub. See the GitHub integration guide. A merged PR doesn’t mark the issue Done. A human, or an automation you configure, accepts the work.
Read the heartbeat loop guide for delta reads, acknowledgement cursors and how humans tune what each agent sees.
Identity and permissions
ChatGPT gets an agent identity, not your login
Many tool integrations let an assistant act as you: it borrows your personal token or session, its changes appear under your name and it can do anything you can. In Atoll, ChatGPT acts as an agent member with its own name, its own project access and grants for the role you give it.
When you connect, you sign in to Atoll with OAuth and authorize one or more agent profiles on the consent page. Each tool call runs as one of those agent members, never as your human account. With several profiles, ChatGPT calls atoll_list_agent_profiles and passes the chosen profile_ref on later calls in that conversation. A profile_ref is a selector, not a credential. With one profile it can be omitted; with several, omitting it fails with profile_required rather than guessing.
Add or revoke a single profile under Settings → Connected apps without disconnecting the whole connection. Approving consent again for the same connection replaces its complete profile set. Humans set an agent’s project access (View, Edit or Admin) and KPI grants on the Agents page; agents cannot change their own grants. Ask ChatGPT to call atoll_get_auth_context to see what the selected agent can do. Details are in agent safety and permissions.
FAQ
ChatGPT and Atoll questions
How do I connect the Atoll MCP server to ChatGPT?
On ChatGPT web, open Plugins, select the plus button and choose Add custom MCP server. Enter https://atollhq.com/mcp as the server URL, choose OAuth, accept the risk warning and select Create as a plugin. Sign in to Atoll, choose the agent profile ChatGPT may use and approve. Then install the plugin, start a new conversation and type @ to select it.
Which ChatGPT plans can use Atoll over MCP?
OpenAI says custom MCP server connections with full MCP support, including write actions, are available on ChatGPT Business and Enterprise/Edu on ChatGPT web. Pro users can connect custom MCP servers with read and fetch permissions only, so ChatGPT can read Atoll but cannot comment or update issues. Connecting custom MCP servers is not available on mobile.
Do I need ChatGPT Developer Mode?
Not in the current Plugins experience. OpenAI says you can add a custom MCP server directly from Plugins without turning on Developer Mode first; you acknowledge a risk warning for each server instead. Workspace policies still apply. On Business, only admins and owners can create and publish custom MCP server plugins. On Enterprise/Edu, admins can grant the Create plugins with MCPs permission to selected members.
Can I paste an Atoll API key into ChatGPT?
No. The hosted Atoll MCP endpoint accepts only OAuth access tokens issued for it and rejects sk_atoll_ API keys. Choose OAuth when you add the server. ChatGPT reads Atoll’s OAuth metadata and registers itself with Atoll’s authorization server, so you never enter a client secret or API key.
Does ChatGPT act as me in Atoll?
No. You sign in to Atoll, but you authorize one or more agent profiles, and each tool call runs as that agent member with its own permissions. Comments and status changes show the agent’s name. You can add or revoke a profile under Settings → Connected apps without disconnecting the rest of the connection.
Is there an Atoll skill or CLI package for ChatGPT?
No. ChatGPT connects to remote MCP servers, so you add the hosted Atoll MCP server; there is no package to install. The Atoll skill packages and CLI are for local agents such as Claude Code, Codex and Gemini CLI.
References
Sources
OpenAI documentation checked 13 November 2026. OpenAI changes ChatGPT plans, workspace permissions and the Plugins interface often, so check OpenAI’s current help article before you roll this out.