Weft
EN

By OpenAI

Connect Codex CLI to your task board

Your OpenAI CLI agent, on the board.

To connect Codex CLI to a task board, add Weft — a task board with an MCP server — to Codex CLI and sign in once. It takes about three minutes and is free for 50 tasks. After that, Codex CLI creates, moves and finishes tasks on your board when you ask.

Weft is the AI task manager for solo founders and small teams.

OpenAI's open-source coding CLI. Capture tasks as you refactor, run them through a sprint, and keep your work visible.

Codex CLI MCP setup

Codex CLI MCP docs ↗

Codex CLI config evolves quickly — verify the latest syntax in the Codex repo if this snippet fails.

  1. 01

    Create a free Weft account.

    Weft is free for 50 tasks. Pro from $5/seat/month billed yearly.

    Sign up — 60 seconds
  2. 02

    Add Weft to your Codex CLI config.

    ~/.codex/config.toml
    [mcp_servers.weft]
url = "https://letsweft.com/api/mcp"
    MCP endpoint
    https://letsweft.com/api/mcp
  3. 03

    Complete the OAuth popup.

    On first use, Codex CLI opens a browser window so you can authorize with your Weft account. Sign in once — the client remembers you after that.

  4. 04

    Verify it works.

    Run `codex mcp login weft` to sign in through the browser, then start `codex` and ask: "what's on my board?". `/mcp` lists the connected server and its tools.

Try these prompts

Everything below works once you’re connected — Codex CLI picks the right Weft tool on its own.

  • “Add a task: "profile the slow render in Board.tsx".”
  • “What is currently in Doing?”
  • “Move the payments bug into the current sprint.”

Codex CLI and MCP: common questions

Does Codex CLI support MCP?

Yes. Codex CLI connects to remote MCP servers, and Weft is one: a single endpoint, https://letsweft.com/api/mcp. You sign in once in the browser; there is no API key to copy.

Where do I add an MCP server in Codex CLI?

In ~/.codex/config.toml. The snippet in step 2 is the whole Weft entry.

Is Weft free to use with Codex CLI?

Yes, for up to 50 tasks, with no credit card. Pro removes the limit.

What can Codex CLI do on my Weft board?

Create, update, move and complete tasks, plan and run sprints, sort work into projects and search across all of it: 32 MCP tools in all.

Learn more about Weft

All integrations

Put Codex CLI on your board.

Start free with 50 tasks. Upgrade when your AI fills the Backlog.

Start freeSee pricing

Trouble connecting? Contact support