By Google

Connect Gemini CLI to your task board

Google's terminal AI, official Weft extension.

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

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

Google's open-source Gemini CLI. Weft ships an official extension — one command installs the MCP connection plus a context file that teaches Gemini the board's conventions.

Gemini CLI MCP setup

Gemini CLI MCP docs ↗

Prefer manual config? Skip the extension and add the MCP endpoint below under "mcpServers" (key: "weft", field: "httpUrl") in ~/.gemini/settings.json — same server, no context file.

  1. 01

    Create a free Weft account.

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

  2. 02

    Add Weft to your Gemini CLI config.

    bash
    gemini extensions install https://github.com/AndreiFinogeev/weft-gemini-extension
    MCP endpoint
    https://letsweft.com/api/mcp
  3. 03

    Complete the OAuth popup.

    On first use, Gemini 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 `gemini` and ask: "what's on my weft board?". A browser opens for OAuth on first use. `gemini extensions list` should show "weft".

Try these prompts

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

  • “Create a task: "write launch blog post", priority high, due Friday.”
  • “Which tasks are in the active sprint?”
  • “Move "landing hero copy" to Done.”

Gemini CLI and MCP: common questions

Does Gemini CLI support MCP?

Yes. Gemini 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 Gemini CLI?

You don’t edit a file by hand: the command in step 2 adds the Weft entry to Gemini CLI for you.

Is Weft free to use with Gemini CLI?

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

What can Gemini 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 Gemini CLI on your board.

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

Trouble connecting? Contact support