Skip to main content
Relevance AI Docs
Log InSign Up
Getting StartedBuild with Relevance AIIntegrationsAccess & AdministrationEnterpriseGuides

MCP & Plugins

OpenAI Codex

Connect OpenAI Codex to Relevance AI using the MCP server and agent skills.

OpenAI Codex is OpenAI’s cloud-based coding agent. You can connect it to Relevance AI by adding the MCP server and cloning the agent skills repository — giving Codex full access to your agents, tools, workforces, and knowledge.

Quick start

Add the MCP server

Register the Relevance AI MCP server with Codex:

codex mcp add relevance-ai --url https://mcp.relevanceai.com/

Authenticate

Log in to your Relevance AI account:

codex mcp login relevance-ai

This opens your browser to authenticate. You only need to do this once per project.

Clone the agent skills

Give Codex built-in knowledge of Relevance AI by cloning the agent skills repository:

git clone https://github.com/RelevanceAI/agent-skills ~/.agents/skills/relevance-ai

This provides Codex with detailed context on how to work with agents, tools, workforces, knowledge, and more — so it can handle complex tasks correctly on the first try.

Tip: Learn more about what’s included in the agent skills on the Agent Skills page.

Start building

You’re ready to go. Try one of the example prompts below or describe what you want to build.

Example prompts

Once connected, you can start building immediately:

> Create a BDR agent that qualifies inbound leads from HubSpot
> Set up a workforce where a triage agent routes support tickets to specialist agents

Working with multiple projects

If you work across multiple Relevance AI projects, add a separate MCP server entry for each:

codex mcp add relevance-project-1 --url https://mcp.relevanceai.com/
codex mcp login relevance-project-1

codex mcp add relevance-project-2 --url https://mcp.relevanceai.com/
codex mcp login relevance-project-2

Each entry authenticates independently against its own project.

Troubleshooting

MCP server not connecting
  • Ensure you have run codex mcp add relevance-ai --url https://mcp.relevanceai.com/
  • Check that authentication completed successfully with codex mcp login relevance-ai
  • Verify your internet connection and that https://mcp.relevanceai.com/ is accessible
Authentication issues
  • Make sure you have an active Relevance AI account
  • Check that you have access to the project you are trying to connect to
  • Try re-authenticating with codex mcp login relevance-ai
Tools not appearing
  • Verify you have completed authentication
  • Check that your Relevance AI project has tools and agents configured
  • Try removing and re-adding the MCP server
Codex not using agent skills
  • Confirm the agent skills are cloned to the correct path: ~/.agents/skills/relevance-ai
  • Run ls ~/.agents/skills/relevance-ai/SKILL.md to verify the files exist
  • Pull the latest version: cd ~/.agents/skills/relevance-ai && git pull