Connect Codex with the Busabase plugin

The Busabase plugin is the fastest way to use Busabase Cloud from Codex. It installs a hosted OAuth MCP profile plus two reusable skills:

• $busabase for inspecting workspaces, proposing Change Requests, and working with approved data.
• $busabase-app-creator for building a complete Busabase workspace app.

The plugin is published from the public busabase/skills repository. No Busabase API key is required.

1. Add the marketplace and plugin

Run these commands in your terminal:

codex plugin marketplace add busabase/skills
codex plugin add busabase@busabase

The first command registers the GitHub repository as the busabase marketplace. The second installs the busabase plugin from that marketplace.

Check both states:

codex plugin marketplace list
codex plugin list

You can also start Codex and enter /plugins to inspect the installed plugin and its bundled skills.

2. Authorize the Cloud MCP connection

Plugin installation and MCP authorization are separate. Start the Busabase OAuth flow:

codex mcp login busabase --scopes mcp
codex mcp list

Complete the browser flow with the Busabase account that owns the target workspace. Choose the smallest useful permission and a finite expiration. For normal agent work, prefer changeRequest.

In codex mcp list, the busabase row should show OAuth authentication. If it still says Not logged in, rerun the login command and complete the newly opened browser tab while the command is active.

3. Start a new Codex task

Start a new task after installation and login so Codex loads the plugin's skills and authenticated tool catalog. In the new task:

1. Enter /plugins and confirm Busabase is installed and enabled.
2. Enter /mcp and confirm the busabase server is connected.
3. Ask Codex to call auth_verify.
4. If more than one space is returned, choose one and use its id as targetSpaceId.
5. Ask Codex to call bases_list as a read-only smoke test.

Busabase rejects ambiguous multi-space calls instead of guessing.

4. Use the bundled skills

Describe the outcome directly, or invoke a skill explicitly:

$busabase list the Bases in my selected workspace and summarize their purpose.

$busabase-app-creator create a lightweight content calendar app in Busabase.

The plugin follows Busabase's approval-first workflow. It may propose a Change Request, but it must not review, merge, or close one unless you explicitly direct that decision.

Update or reconnect

Refresh the Git-backed marketplace:

codex plugin marketplace upgrade busabase

Start a new Codex task after an update so it loads the refreshed bundle.

To switch Busabase accounts or replace an expired grant:

codex mcp logout busabase
codex mcp login busabase --scopes mcp
codex mcp list

If your organization blocks Git marketplace sources, ask the workspace administrator to allow https://github.com/busabase/skills, or use the direct MCP setup instead.

Which setup should I use?

Codex plugin documentation · Busabase skills and plugin source