Peak OSPeak OS Connect AI

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?"

Peak OS MCP server URL
https://peakos.collective-genius.com/mcp
You'll paste this into your AI app.
ChatGPTWeb, Windows and Mac apps, phone
ClaudeWeb, desktop and phone, sign in with Peak
Claude desktop extensionDownload, double-click, paste a key
Claude CodeOne command
CodexChatGPT desktop app, CLI or IDE

Before you start

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.

  1. Go to chatgpt.com/plugins and sign in.
  2. Click the + button, then Add custom MCP server.
  3. Name: Peak OS. Server URL: https://peakos.collective-genius.com/mcp. Authentication: OAuth.
  4. Click I understand and want to continue, then Create as a plugin.
  5. 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.
  6. 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.

  1. Open Customize > Connectors in Claude.
  2. Click + Add, then Add custom connector.
  3. Name: Peak OS. URL: https://peakos.collective-genius.com/mcp. Click Continue.
  4. Keep the suggested sign-in settings, click Continue, then Add.
  5. Click Connect, sign in to Peak, choose your access and click Allow.
  6. 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.

  1. 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).
  2. Download the extension: Download peak-os.mcpb
  3. Double-click the file. Claude desktop opens it. (Or, in Claude, go to Settings > Extensions > Advanced settings > Install Extension and pick the file.)
  4. Click Install, paste your key into Peak API key, and leave Peak URL as it is.
  5. 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/mcp

Then 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-os

The 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

If something goes wrong

Everything the AI can do
ToolWhat it doesNeeds "make changes"
list_organizationsList my organizationsNo
whoamiWho am I in PeakNo
list_membersList organization membersNo
list_teamsList teamsNo
list_todosList to-dosNo
get_todoGet a to-doNo
create_todoCreate a to-doYes
update_todoUpdate a to-doYes
list_triage_itemsList triage itemsNo
get_triage_itemGet a triage itemNo
create_triage_itemCreate a triage itemYes
update_triage_itemUpdate a triage itemYes
resolve_triage_itemDefer, finish, reopen or convert a triage itemYes
list_objectivesList objectivesNo
get_objectiveGet an objective with its key resultsNo
create_objectiveCreate an objectiveYes
update_objectiveUpdate an objectiveYes
create_key_resultCreate a key resultYes
update_key_resultUpdate a key resultYes
get_key_resultGet a key resultNo
list_updatesList progress updatesNo
post_updatePost a progress updateYes
add_measureAdd a measure to a key resultYes
update_measureUpdate a key result measureYes
list_initiativesList initiatives for a key resultNo
create_initiativeCreate an initiativeYes
update_initiativeUpdate an initiativeYes
list_metricsList metricsNo
create_metricCreate a metricYes
list_metric_valuesList a metric's period valuesNo
update_metricUpdate a metricYes
set_metric_valueRecord a metric value for a periodYes
list_meetingsList meetingsNo
get_meetingGet a meetingNo
create_meetingSchedule a meetingYes
update_meetingUpdate a meetingYes
archive_meetingArchive a meetingYes
get_foundationsGet organization foundationsNo
get_plansGet the three-year vision and one-year planNo
peak_api_requestCall any Peak API v1 endpointYes

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