Codex Integrations and Connections

Codex supports integration with various development tools and platforms, extending its capabilities and use cases.

GitHub Integration

Codex has deep integration with GitHub, allowing code review directly in PRs.

Feature Overview

Features	Description
PR Review	Get reviews by @codex review in PR comments
Automatic Review	Automatically trigger reviews for every new PR
CI Fix	@codex fix the CI failures
Cloud Tasks	Other @codex directives start cloud tasks

Set up GitHub Integration

Configure Codex Cloud
Go to the settings page to enable Code Review
Authorize access to your GitHub repositories
Select repositories to enable

Request Review

Used in PR

# Enter in PR comment
@codex review

# Specify review focus
@codex review for security issues

# Review performance issues
@codex review for performance regressions

Codex Response

Codex will:

React to PR 👀
Analyze code changes
Publish review comments
Flag discovered issues (P0 and P1 by default)

Customize review guidelines

Define review rules in the repository's AGENTS.md:

Review Guidelines

## Review guidelines

- Don't log PII (personally identifiable information)
- Verify authentication middleware wraps every route
- Check for SQL injection vulnerabilities
- Ensure error messages don't leak sensitive info
- Treat typos in docs as P1 issues

Codex by default only flags P0 and P1 issues, which can be adjusted in AGENTS.md.

Slack Integration

Through Slack integration, team members can use Codex directly in channels.

Set up Slack Integration

Go to the Codex settings page
Find the Integrations section
Add the Slack app
Authorize access to the Slack workspace

Usage

Used in Slack

# In Slack channel
@codex review this PR: https://github.com/xxx/pull/123

# Explain code
@codex explain this function

# Assign task
@codex fix the bug in auth module

Applicable scenarios

Quickly get AI assistance during team collaboration discussions
Delegate tasks to remote team members
Asynchronous work scenarios

Linear Integration

Linear is a project management tool, and Codex can integrate with it to handle Issues.

Set up Linear Integration

Go to the Codex settings page
Add the Linear integration
Authorize access to the Linear workspace
Configure issue handling rules

Use Case

Scenarios	Description
Issue Handling	Automatically create code changes based on Issues
Sync review results	Add review findings to issues
Status Update	Automatically update Issue status
Comment Replies	@codex in issue comments

MCP（Model Context Protocol）

MCP is a protocol that connects Codex with external tools.

MCP Overview

STDIO server: Local process, communicating via standard input/output
HTTP server: Remote server, communicating via HTTP API

Configure MCP servers

MCP Configuration

# ~/.codex/config.toml

# STDIO Server
[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

# HTTP Server
[mcp_servers.api]
url = "https://api.example.com/mcp"
bearer_token_env_var = "API_TOKEN"

Common MCP servers

Server	Features
filesystem	File system access
github	GitHub API
postgres	PostgreSQL database
fetch	Web Scraping
openai-docs	OpenAI Documentation

MCP tool permissions

Tool permission configuration

# Tool Whitelist
[mcp_servers.filesystem]
enabled_tools = ["read_file", "write_file"]

# Tool Blacklist
disabled_tools = ["delete_file"]

# Tool Approval Mode
[mcp_servers.filesystem.tools.write_file]
approval_mode = "ask" # ask | approve | deny

OAuth authentication configuration

Some MCP servers require OAuth authentication:

OAuth Configuration

[mcp_servers.figma]
url = "https://api.figma.com/mcp"
scopes = ["file:read"]
oauth_resource = "codex-integration"

# OAuth callback port
mcp_oauth_callback_port = 8080

# Credential storage
mcp_oauth_credentials_store = "keyring"

FAQ

Q: What plan does GitHub integration require?

Requires a Codex Cloud subscription (Plus or above).

Q: Can I restrict which repositories Codex can access?

You can selectively authorize repositories in settings.

Q: How are MCP servers installed?

Most MCP servers are installed via npm, and Codex manages them automatically.

Q: Are other integrations supported?

Codex continuously adds new integrations; follow official updates.

other extensions