Docs › Sidekick for AI

Connect to Codex

On the cloud, run codex mcp add sidekick with the Sidekick for AI address and approve it once. On your Mac, add Sidekick's local address and key to ~/.codex/config.toml.

On the cloud

In your terminal, add Sidekick for AI:

codex mcp add sidekick --url https://mcp.heysidekick.app/mcp

If Codex doesn’t ask you to sign in, run:

codex mcp login sidekick

Sidekick’s approval page opens in your browser: pick your Google account, or choose Continue with Google and sign in on Google’s page, then choose which lists Codex can use.

On this Mac

With Sidekick for Mac set to On this Mac, add Sidekick to ~/.codex/config.toml, with the key from Sidekick’s Settings › Sidekick for AI:

[mcp_servers.sidekick]
url = "http://127.0.0.1:46340/mcp"
http_headers = { Authorization = "Bearer sk-local-YOUR-KEY" }

Restart Codex so it picks up the new server. It works while Sidekick is open.

Using it

Ask Codex about your tasks, for example “What’s due this week?” To check it works, ask it to list your task lists. Deletes are previewed before you approve them.

Last updated