Documentation
MCP (AI Agents)
Set Up with OpenAI Codex

Set Up with OpenAI Codex

OpenAI Codex is OpenAI’s CLI coding agent. It supports MCP servers through its configuration UI, letting Codex control ButterKit from your terminal.

Prerequisites

  • ButterKit running with MCP enabled (Settings > MCP)
  • OpenAI Codex CLI installed

Configuration

Open the MCP config

In the Codex MCP configuration UI, add a new server with the following details:

Enter connection details

FieldValue
Namebutterkit
TransportSTDIO
Command to launch/Applications/ButterKit.app/Contents/MacOS/butterkit-mcp
Arguments(none)

Verify the connection

Start a new Codex session. ButterKit’s 40 tools should be available. Confirm by asking Codex to list your open documents.

Start using it

Ask Codex to work with your ButterKit project. For example:

  • “Show me all artboards in my ButterKit document”
  • “Set the background to a blue gradient on the first artboard”
  • “Export all artboards as @2x PNGs”

Tips

  • Codex runs tasks in sandboxed environments, so make sure ButterKit is running on your machine before starting a session.
  • For step-by-step recipes, see Workflows.

Quick Help

Set Up with Claude CodeTool Reference