Connect your AI

Every app connects to the same address:

https://agent.omnistatic.com/mcp

It's a remote MCP server (Streamable HTTP) with OAuth 2.1 sign-in. When you connect, your app opens Omni's consent page at dash.omni.channel/connect, where you sign in and choose:

• Your Omni memory (shared with the Omni app): whether this app may use your Personal space. Ticked by default.
• All workspaces, including ones you make later, or only the ones you pick. The Inbox is always included.

The page shows the app's name and where it will send you back. Only continue if you started the connection yourself. You can change your mind at any time by disconnecting the app (Connected apps and API keys).

Tested with Omni: Claude (web and desktop), Claude Code, Codex and ChatGPT. Other clients that support remote MCP servers with OAuth should work too.

Claude (claude.ai and Claude Desktop)

1. Open Settings → Connectors.
2. Choose Add custom connector.
3. Name it Omni and paste https://agent.omnistatic.com/mcp.
4. Select Connect and sign in with your Omni account.
5. Start a new chat and ask Claude to list your Omni spaces.

Claude Desktop and the Claude mobile apps use the connectors of the account you're signed in to, so adding Omni once is enough. On Team and Enterprise plans an owner may need to add the connector for the organisation first. On the Free plan Claude allows one custom connector.

Claude Code

claude mcp add --transport http omni https://agent.omnistatic.com/mcp

Then type /mcp in Claude Code, choose omni and sign in. Add --scope user to the command to use Omni in every project rather than only the current one.

To use an API key instead of signing in:

claude mcp add --transport http omni https://agent.omnistatic.com/mcp \
  --header "Authorization: Bearer omni_dev_..."

Codex

The Codex CLI, IDE extension and desktop app share one configuration, so you only add Omni once.

In a terminal:

codex mcp add omni --url https://agent.omnistatic.com/mcp
codex mcp login omni

The second command opens Omni's sign-in in your browser.

In the Codex desktop app: open Settings → MCP servers, add a server named omni with the URL https://agent.omnistatic.com/mcp, and sign in when asked.

The command writes this to ~/.codex/config.toml, which you can also edit by hand:

[mcp_servers.omni]
url = "https://agent.omnistatic.com/mcp"

ChatGPT

ChatGPT connects to custom MCP servers in developer mode, on the web.

1. Open Settings → Apps & Connectors → Advanced and turn on Developer mode.
2. Create a connector named Omni with the URL https://agent.omnistatic.com/mcp.
3. For Authentication, choose the sign-in (OAuth) option, not "No authentication".
4. Sign in with your Omni account.
5. Start a new chat, pick Omni in the tools menu, and ask ChatGPT to list your Omni spaces.

Cursor

Add Omni to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "omni": {
      "url": "https://agent.omnistatic.com/mcp"
    }
  }
}

Open Cursor's MCP settings, find omni and sign in when asked.

Other MCP clients

Any client that speaks MCP over Streamable HTTP can connect:

• With sign-in: the client discovers Omni's OAuth server from the WWW-Authenticate header of its first request and registers itself with a client ID metadata document or dynamic client registration. See Authentication.
• Without sign-in: send an API key in the Authorization: Bearer omni_dev_... header.

Omni answers with JSON (no server-sent events) and keeps no session, so every request stands alone.

Check that it works

Ask your AI to "list my Omni spaces". It should name Personal (if you allowed it), Inbox and your own spaces. If it says it can't find Omni, start a new chat: most apps load connectors when a chat starts.