Connect your AI app to Peak OS
Takes about two minutes. Pick your app below and follow the steps. Then ask things like "What are my to-dos this week?"
https://peakos.collective-genius.com/mcpBefore you start
- API access must be on for you. A Peak admin turns it on. If Peak says API access is off, contact Peak support.
- The AI acts as you. It works with your permissions and can't see anything you can't. If you're in more than one organization, one connection covers all of them; just name the organization in your request, or the AI will ask.
- You choose the access. When you sign in, pick View only or View and make changes.
- Disconnect any time. Each connection is listed on your API Keys page in Peak (top-right menu). Revoke it there.
ChatGPT
Set it up once in a web browser. After that, Peak OS works in ChatGPT on the web, in the Windows and Mac apps, and on your phone.
- Go to chatgpt.com/plugins and sign in.
- Click the + button, then Add custom MCP server.
- Name:
Peak OS. Server URL:https://peakos.collective-genius.com/mcp. Authentication: OAuth. - Click I understand and want to continue, then Create as a plugin.
- When ChatGPT opens Peak, sign in, choose your access and click Allow. If ChatGPT then shows an Install or + button on the Peak OS plugin, click it.
- In any chat, type @Peak OS and ask your question.
Don't see Plugins, or Add custom MCP server is missing?
- On a ChatGPT Business, Enterprise or Edu workspace, your ChatGPT admin may need to let you add custom MCP servers.
- Some accounts still have the older menu. Open Settings > Apps, turn on Developer mode under Advanced settings, click Create app, and use the same name, URL and OAuth. Then pick Peak OS from the + menu in a chat.
Claude
Works in claude.ai, the Claude desktop app and the Claude phone app.
- Open Customize > Connectors in Claude.
- Click + Add, then Add custom connector.
- Name:
Peak OS. URL:https://peakos.collective-genius.com/mcp. Click Continue. - Keep the suggested sign-in settings, click Continue, then Add.
- Click Connect, sign in to Peak, choose your access and click Allow.
- In a chat, click +, then Connectors, and make sure Peak OS is on.
Team or Enterprise plan, free plan, or trouble signing in?
- Team or Enterprise: an owner adds the connector first, in Organization settings > Connectors (Add, then Custom, then Web), with the same name and URL. Then each person opens Customize > Connectors, finds Peak OS and clicks Connect.
- Free plan: you can add one custom connector.
- Sign-in says "This app isn't registered": remove the connector, add it again, and under OAuth client choose Register automatically.
- Can't add custom connectors? Use the Claude desktop extension instead.
Claude desktop extension
Another way to connect the Claude desktop app on Windows or Mac. Use it if you can't add custom connectors, or if you'd rather use an API key than sign in. Pick one way, not both, or Claude will see every Peak tool twice.
- In Peak, open the top-right menu, choose API Keys and click Create Key. Choose Read & write if you want Claude to make changes. Copy the key (it starts with
pk_and Peak shows it only once). - Download the extension: Download peak-os.mcpb
- Double-click the file. Claude desktop opens it. (Or, in Claude, go to Settings > Extensions > Advanced settings > Install Extension and pick the file.)
- Click Install, paste your key into Peak API key, and leave Peak URL as it is.
- Start a new chat and ask "Who am I in Peak?"
Nothing else to install: Claude desktop includes everything the extension needs. Your key is stored in your computer's keychain.
Claude Code
Run this in a terminal. It adds Peak OS to every project:
claude mcp add --transport http --scope user peak-os https://peakos.collective-genius.com/mcpThen start Claude Code, type /mcp, pick peak-os and sign in to Peak in the browser window that opens.
Codex
Codex in the ChatGPT desktop app, the Codex CLI and the IDE extension share one setup, so you only do this once. Run these two commands in a terminal:
codex mcp add peak-os --url https://peakos.collective-genius.com/mcp
codex mcp login peak-osThe second command opens Peak in your browser. Sign in, choose your access and click Allow.
Rather use the app's settings, or an API key?
In the app: open Settings > MCP servers > Add server. Name: peak-os. Type: Streamable HTTP. URL: https://peakos.collective-genius.com/mcp. Save, then click Restart, and sign in when asked (or run codex mcp login peak-os).
With an API key: create a key on the Peak API Keys page, save it in an environment variable named PEAK_API_KEY, and add this to ~/.codex/config.toml:
[mcp_servers.peak-os]
url = "https://peakos.collective-genius.com/mcp"
bearer_token_env_var = "PEAK_API_KEY"Things to ask
- "What are my open to-dos this week?"
- "Add a to-do for Isaac to send the Q4 board deck, due Friday."
- "Which key results on the leadership team are off track?"
- "Record October revenue actual as 120k."
- "Defer the triage item about the vendor contract."
If something goes wrong
- "API access is turned off": a Peak admin needs to turn on API access for your organization and for you.
- The AI says it can't make changes: you connected with View only, or your Peak role can't edit that item. Remove the connection and connect again with View and make changes.
- It stopped working: the connection was revoked or expired. Connect again (or, for the desktop extension, create a new key and paste it in Settings > Extensions > Peak OS).
- The AI is working in the wrong organization: tell it which organization you mean by name. It can list the organizations your connection reaches.
- "Too many requests": the limit is 100 requests a minute per connection. Wait a minute and try again.
Everything the AI can do
| Tool | What it does | Needs "make changes" |
|---|---|---|
list_organizations | List my organizations | No |
whoami | Who am I in Peak | No |
list_members | List organization members | No |
list_teams | List teams | No |
list_todos | List to-dos | No |
get_todo | Get a to-do | No |
create_todo | Create a to-do | Yes |
update_todo | Update a to-do | Yes |
list_triage_items | List triage items | No |
get_triage_item | Get a triage item | No |
create_triage_item | Create a triage item | Yes |
update_triage_item | Update a triage item | Yes |
resolve_triage_item | Defer, finish, reopen or convert a triage item | Yes |
list_objectives | List objectives | No |
get_objective | Get an objective with its key results | No |
create_objective | Create an objective | Yes |
update_objective | Update an objective | Yes |
create_key_result | Create a key result | Yes |
update_key_result | Update a key result | Yes |
get_key_result | Get a key result | No |
list_updates | List progress updates | No |
post_update | Post a progress update | Yes |
add_measure | Add a measure to a key result | Yes |
update_measure | Update a key result measure | Yes |
list_initiatives | List initiatives for a key result | No |
create_initiative | Create an initiative | Yes |
update_initiative | Update an initiative | Yes |
list_metrics | List metrics | No |
create_metric | Create a metric | Yes |
list_metric_values | List a metric's period values | No |
update_metric | Update a metric | Yes |
set_metric_value | Record a metric value for a period | Yes |
list_meetings | List meetings | No |
get_meeting | Get a meeting | No |
create_meeting | Schedule a meeting | Yes |
update_meeting | Update a meeting | Yes |
archive_meeting | Archive a meeting | Yes |
get_foundations | Get organization foundations | No |
get_plans | Get the three-year vision and one-year plan | No |
peak_api_request | Call any Peak API v1 endpoint | Yes |
With a view-only connection, the change tools are hidden.
Another MCP app
Use Streamable HTTP at https://peakos.collective-genius.com/mcp. Apps that support MCP sign-in (OAuth) sign in on their own. Otherwise send a personal API key:
{
"mcpServers": {
"peak-os": {
"url": "https://peakos.collective-genius.com/mcp",
"headers": {
"Authorization": "Bearer pk_your_key"
}
}
}
}Details for developers
- Transport: MCP Streamable HTTP at
https://peakos.collective-genius.com/mcp, stateless JSON responses (no SSE stream, no session id). - Auth: OAuth 2.1 with PKCE (S256) and dynamic client registration. Personal API keys also work as bearer tokens (
Authorization: Bearer pk_...). - Metadata: oauth-protected-resource and oauth-authorization-server. Scopes:
read,write. - The tools wrap the Peak REST API: API documentation.
- This guide as Markdown, for AI agents: /connect.md.