Skip to content

Connect Codex to Attio

Connect Codex to Attio in 3 steps: 1. Sign in to ApexGenius and connect Attio. 2. Add the ApexGenius plugin. 3. Start using Attio in Codex. Start in Plugins in the ChatGPT desktop app and authorize your connection.

1,000 free credits · No card required

How to connect Attio to Codex

  1. 1Sign in to ApexGenius and connect Attio
  2. 2Add the ApexGenius plugin to Codex
  3. 3Start using Attio in Codex
  1. 1Attio

    Connect Attio to ApexGenius

    Connect Attio

    Attio opens its own sign-in. Sign in and allow ApexGenius.

  2. 2ApexGenius

    Connect ApexGenius to Codex

    Choose Codex

    Back on Start, pick Codex and copy the prompt.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius plugin to Codex

Codex stores MCP servers in ~/.codex/config.toml. The ChatGPT desktop app, the Codex CLI and the IDE extension share that file, so one setup covers all three on the same machine.

  1. In the ChatGPT desktop app, open Plugins and select an ApexGenius plugin shared with you or one you created. Connect it and authorize the app connections you intend to use.
  2. No plugin? Open Settings, then MCP servers, then Add server. Name it ApexGenius, choose Streamable HTTP and paste the MCP address.
  3. Save, select Restart, then Authenticate, and sign in to ApexGenius in your browser.
  4. Start a new Codex task.

The MCP address

https://server.autom8.pro/mcp

Check it. In the composer, type /mcp to view the connected servers.

Steps follow OpenAI documentation, Model Context Protocol for ChatGPT and Codex (opens in a new tab), read November 12, 2026.

Then ask Codex

Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.

Start free
Written setup, step by stepShow

Before you start

  • An account with permission to use the Attio resources you intend to connect.

1. Connect Attio to ApexGenius

  1. Open Attio in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
  2. Choose the account and review access. Sign in to Attio in the browser, choose the workspace, and allow access. Attio uses browser authorization; no API key is pasted into ApexGenius.
    The full Attio sign-in page that opens when you connect Attio, with a red box around the sign-in options.
    Connect opens Attio's sign-in. Sign in with Google or your work email, then allow ApexGenius.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Confirm the connected Attio user and workspace. Open Tools to review the record, list, note and task actions. Your Attio permissions set what the connection can reach.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect Attio →

2. Connect ApexGenius to Codex

The steps are above, under Add the ApexGenius plugin to Codex. These notes apply to Codex only.

  • From the terminal. The commands are under Manual setup for developers. codex mcp list shows the configured servers, and codex mcp login apexgenius runs the sign-in.
  • Without a local browser. Run codex mcp login apexgenius --no-browser, open the printed authorization URL on another machine, sign in, and paste the full redirect URL back into the terminal.
  • Asking before writes. In config.toml, default_tools_approval_mode = "writes" on the apexgenius server makes Codex ask before any tool that is not marked read-only.
  • ChatGPT on the web. ChatGPT on the web does not read local Codex configuration. It uses plugins.
  • Access. When ApexGenius asks what Codex may use, choose Read only for the first test, or Custom to limit it to the tools you need.

Watch the setup

Follow each step at your own pace.

Codex desktop app with Plugins selected and ApexGenius listed under Available to your account.
Open Codex in the ChatGPT desktop app, then Plugins, and find ApexGenius.Open full-size image (opens in a new tab)

The walkthrough uses the original ChatGPT web plugin captures. After connecting, open Codex in the desktop app and start a new task with ApexGenius. A ChatGPT web connection does not verify Codex access.

A public ApexGenius plugin listing is not verified. Use a plugin shared with you or one you created, subject to your account and workspace policy.

Create a personal plugin

Where Developer mode is available, open ChatGPT Settings, then Security and login, and enable it. In Plugins, select the plus button, enter ApexGenius and a description, then add this URL under Connection. Create the connection, complete OAuth, and review the tools. Return to Codex in the desktop app and start a new task with the plugin enabled.

https://server.autom8.pro/mcp
OpenAI custom connection guide (opens in a new tab)
No plugin available? Use desktop settings
  1. In the ChatGPT desktop app, open Settings, then MCP servers, then Add server.
  2. Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address below.
  3. Save, select Restart, then Authenticate. Sign in to ApexGenius and authorize the intended connections and access.
  4. Start a new Codex task and ask one read-only question. Check the returned result and its matching successful read in Activity.
https://server.autom8.pro/mcp
OpenAI desktop MCP settings (opens in a new tab)
Manual setup for developers

Codex CLI is optional. Run these commands, complete browser authorization, then start a new session. Do not paste bearer tokens or static authorization headers.

Register the remote MCP server

codex mcp add apexgenius --url https://server.autom8.pro/mcp

Authorize in your browser

codex mcp login apexgenius

Inspect registered servers

codex mcp list

The desktop app, CLI, and IDE extension share MCP configuration on the same host. The IDE extension does not install plugins. ChatGPT web does not read local Codex configuration.

3. Verify one safe read

Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.

Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.

Compare the returned account and resource with Attio. Check the connection status separately from the result of the first read.

Full guide: the Attio setup guide.

What it looks like in Codex

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Codex
CodexApexGenius MCP route
Who am I in Attio, and which workspace is connected? Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestCheck the account
Account scopeAuthorized connections checked
apex_search_toolsAttio workspace · Find the Attio read routeComplete
apex_call_read_toolwhoami · Read the connected userComplete
Codex

Illustrative example: the connected user is Alex in the Northwind workspace. Compare this with the Attio account you authorized before reading records. Nothing was changed.

Read-only route
Codex

What to ask Codex about Attio

  • Check the account

    Who am I in Attio, and which workspace is connected? Do not change anything.

    Runs whoami (read).

  • Find contacts

    Find every contact at Acme in Attio and show their titles and emails.

    Runs search-records (read), then get-records-by-ids (read).

  • Pipeline by stage

    Count open deals by stage in Attio. Do not change anything.

    Runs list-attribute-definitions (read), then run-basic-report (read).

These 3 questions use 5 of Attio’s 41 operations. The full list is below.

  • Log a note on the Acme company record that sums up today's call. Show me the note first. (write)

What Codex can do in Attio

41 operations: 26 read, 15 write. Read looks things up and changes nothing. Writes change Attio and run only when you turn them on.

Records and objects

5 read · 4 write
  • list-objectsread
  • search-recordsread
  • list-recordsread
  • get-records-by-idsread
  • list-attribute-definitionsread
  • create-recordwrite
  • upsert-recordwrite
  • update-recordwrite
  • merge-recordswrite

Lists and pipelines

3 read · 5 write
  • list-listsread
  • list-list-attribute-definitionsread
  • list-records-in-listread
  • create-listwrite
  • add-record-to-listwrite
  • update-listwrite
  • update-list-entry-by-idwrite
  • update-list-entry-by-record-idwrite

Notes

3 read · 2 write
  • search-notes-by-metadataread
  • semantic-search-notesread
  • get-note-bodyread
  • create-notewrite
  • update-notewrite

Tasks

1 read · 2 write
  • list-tasksread
  • create-taskwrite
  • update-taskwrite

Comments

2 read · 2 write
  • list-commentsread
  • list-comment-repliesread
  • create-commentwrite
  • delete-commentwrite

Meetings and calls

4 read
  • search-meetingsread
  • search-call-recordings-by-metadataread
  • semantic-search-call-recordingsread
  • get-call-recordingread

Emails

3 read
  • search-emails-by-metadataread
  • semantic-search-emailsread
  • get-email-contentread

Workspace

3 read
  • whoamiread
  • list-workspace-membersread
  • list-workspace-teamsread

Reports and SQL

2 read
  • run-basic-reportread
  • query-particle-sqlread

You choose the access. When you approve Codex, pick Full access, Read only, or Custom.

The connection acts as the Attio user who signed in. Attio permissions set what it can reach; ApexGenius does not add a record-level allowlist.

The read route checks Attio's live tool labels and rejects writes or unlabeled operations.

Writes run immediately. Blocked hides a tool from agents.

Merges and deleted comments cannot be undone here, and there is no delete for records, lists, notes or tasks. Remove those by hand in Attio.

query-particle-sql is not on every Attio plan, and Attio limits calls per workspace. Disconnecting stops future access; it does not undo a change that already ran.

Start free

Questions about connecting Codex to Attio

Updated November 12, 2026.

How do I connect Codex to Attio?

Sign in to ApexGenius and connect Attio. In the ChatGPT desktop app, open Plugins and connect an ApexGenius plugin, or open Settings, then MCP servers, then Add server, and add the ApexGenius MCP address as a Streamable HTTP server. Then ask Codex: “Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.” Start with a read, so nothing changes.

How do I check that Codex can use Attio?

In the Codex composer, type /mcp to view the connected servers. ApexGenius should be listed. If it asks for sign-in, open Settings, then MCP servers, and select Authenticate. Start a new task, then ask: “Use whoami to show which Attio user and workspace are connected, then list the lists in my workspace. Do not change anything.”

What can my AI read in Attio?

People, companies, deals and custom records, lists and their entries, notes, tasks, comments, synced meetings, call recordings and emails, plus reports. It sees only what your Attio user can see.

Can my AI change records?

Yes. It can create and update records, list entries, notes and tasks, and merge records. Writes run immediately. Blocked hides a tool from agents.

Can it delete records?

No. Attio's MCP has no delete for records, lists, notes or tasks. The only delete is for a comment you created. Merges cannot be undone here.

Why did a SQL question fail?

query-particle-sql is not on every Attio plan. Ask the same question as a report instead; run-basic-report handles counts, sums and averages.

Connect Attio to Codex today

Start free

1,000 free credits. No card required. Disconnect any time.