Connect Spline to Codex
3D design tool that runs in the browser. Its hosted MCP server lets agents build and edit scenes and generate 3D models and images, and the result is an editable Spline file, not code.
MCP serverOfficialChecked 2026-11-16
Before you start
- Codex installed (see its MCP documentation (opens in a new tab)).
- Spline is available on macOS, Windows, Linux and the web.
- Your agent opens a Spline sign-in page the first time it connects. Each conversation runs in a cloud editor, so nothing has to be open on your machine. Tool calls are limited per day by plan (20 on Free, 100 on Hobby, 200 on Pro, 400 on Max), with a per-minute cap on top.
3d_publish_exportpublishes the scene to a public URL, so keep it for when you mean to. Spline's desktop app has its own server for macOS and Windows; its paths depend on your machine, so set that one up from Spline's docs.
Step 1: Add Spline to Codex
Add it from the terminal
Saves the server to
~/.codex/config.toml, so it works in every project.Terminal codex mcp add spline --url https://mcp.spline.design/mcpOr edit the config file
Add this to
~/.codex/config.toml.~/.codex/config.toml [mcp_servers.spline] url = "https://mcp.spline.design/mcp"Good to know- Sign in once with
codex mcp login spline.
- Sign in once with
Step 2: Check it's connected
Terminal codex mcp listIn a Codex session, run
/mcpto see connected servers and their tools.Step 3: Try a first request
Ask Codex something that only works with Spline connected:
Say to Codex Create a new Spline scene with a glass card floating over a soft gradient, then tell me what you built.
If it doesn't work
- Codex reads
~/.codex/config.toml. A project.codex/config.tomlis only read in projects you have trusted. - Codex doesn't expand
~or environment variables incommand. Use a full path in the config file. - Servers that need a sign-in: run
codex mcp login <name>.





