Skip to main content
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

1

Add the MCP server

Register the Relevance AI MCP server with Codex:
codex mcp add relevance-ai --url https://mcp.relevanceai.com/
2

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.
3

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.
Learn more about what’s included in the agent skills on the Agent Skills page.
4

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

  • 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
  • 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
  • Verify you have completed authentication
  • Check that your Relevance AI project has tools and agents configured
  • Try removing and re-adding the MCP server
  • 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