Microsoft Project Online retires September 30, 2026, migrate to a modern platform before it's too late.Start migration
How-to · About 3 minutes

How to connect Onplana to Gemini CLI + Code Assist

One-line install. Onplana ships a Gemini extension manifest at the repo root, so the entire setup is:gemini extensions install <repo>.

What you’ll be able to do after: ask Gemini things like “summarize my overdue Onplana tasks,” “create a Q3 launch project plan with 5 weekly milestones,” or “list my team members on the data-platform project,” and Gemini executes directly in Onplana.

Open Onplana → Integrations Gemini CLI on GitHub

TL;DR — three commands

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

Detailed steps below.

The five steps in detail

  1. 1

    Install Gemini CLI (if you haven't already)

    On macOS / Linux: npm install -g @google/gemini-cli. On Windows: same command in a Node-enabled shell. Verify with `gemini --version`. If you're using Gemini Code Assist in VS Code or JetBrains, you already have what you need — Code Assist shares the same configuration file as the CLI.

  2. 2

    Generate an Onplana connection token

    Sign in to Onplana at app.onplana.com. Go to Integrations → AI agents → Generate connection (under the "Other MCP client" tile). Copy the personal access token (it starts with `pat_`). Set it as an environment variable: export ONPLANA_PAT=pat_your-token-here (add the line to ~/.bashrc or ~/.zshrc to persist it).

  3. 3

    Install the Onplana Gemini extension (one command)

    Run: gemini extensions install https://github.com/Onplana/onplana-mcp-server. The Onplana repo ships a gemini-extension.json manifest at the root, which Gemini CLI reads to wire up the MCP server connection automatically. Alternative: edit ~/.gemini/settings.json by hand — the format is documented at developers.google.com/gemini-code-assist/docs.

  4. 4

    Restart the Gemini CLI or reload your editor

    For Gemini CLI: exit and reopen `gemini`. For Gemini Code Assist in VS Code: Cmd/Ctrl+Shift+P → "Developer: Reload Window". For JetBrains: restart the IDE. The Onplana tools appear in the /mcp picker after restart.

  5. 5

    Verify the connection

    In a fresh Gemini session, ask: "list my Onplana projects via the onplana tool". Gemini calls Onplana's list_projects tool and shows you the result. If you get an error: re-check that ONPLANA_PAT is set in the environment Gemini is using, confirm your Onplana plan tier includes MCP (PRO and above), and confirm the extension manifest installed correctly with `gemini extensions list`.

Or wire it up by hand

If you prefer not to use the extension install, edit~/.gemini/settings.json(or .gemini/settings.jsonat the workspace root) directly:

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

Note the key is httpUrl, not url. Gemini CLI uses httpUrl for Streamable HTTP servers like Onplana, and reserves url for SSE-based servers. The bearer token in headers.Authorizationauthenticates each request.

How to verify it’s working

Open a fresh Gemini session and try any of:

  • “Via the onplana tool, list my projects.”
  • “Show me overdue Onplana tasks assigned to me.”
  • “Create an Onplana task in project X called ‘Migrate Postgres to Aurora’.”
  • “Search my Onplana wiki for notes about the API migration.”

Run gemini extensions list to confirm the Onplana extension is installed. The /mcp picker should show 27 tools after a successful install.

Frequently asked

Does this work with Gemini Code Assist in VS Code?

Yes. Gemini CLI and Gemini Code Assist share the same config file (~/.gemini/settings.json on user-wide install, or .gemini/settings.json in a workspace). One install via `gemini extensions install` covers both surfaces. After install, reload the VS Code window (Cmd/Ctrl+Shift+P → "Developer: Reload Window") so Code Assist picks up the new config.

What about the consumer Gemini app at gemini.google.com?

gemini.google.com does not yet support custom MCP servers as of May 2026. Google directs users wanting to connect to third-party MCP servers to Gemini CLI or Gemini Code Assist instead. We track this; if the consumer app adds MCP support, the install flow will be one-click via a connectors UI similar to Claude.ai.

What about Gemini Enterprise / Vertex AI Agent Builder?

Gemini Enterprise uses a different OAuth-only admin flow via the Cloud Console (Data stores → Create data store → Custom MCP Server). It is admin-managed, not user-self-serve. For Gemini Enterprise setup, contact mcp@onplana.com with your Cloud Console project ID; we provision per-tenant OAuth credentials.

Which Onplana plan includes MCP access?

MCP access is included with the PRO plan ($12/seat/month, $10 annual) and above. FREE and STARTER plans do not include MCP. You can upgrade or downgrade at any time from app.onplana.com/billing.

What's the difference between the gemini-extension.json install and editing settings.json directly?

Functionally equivalent. The extension install path is one command and uses a manifest at the repo root so the install is reproducible. The settings.json hand-edit is useful when you want to layer Onplana on top of multiple MCP servers (e.g. one for Onplana, one for Linear, one for an internal API) inside the same `mcpServers` object. Either works — they share the same underlying config.

Why is the key called httpUrl and not url?

Gemini CLI distinguishes between stdio-based MCP servers (key: command), SSE-based (key: url), and Streamable HTTP (key: httpUrl). Onplana's MCP server uses Streamable HTTP — the newer transport standard that handles request/response over plain HTTPS without SSE. The `url` key in Claude Desktop, Cursor, and ChatGPT configs is equivalent.

Can I revoke the connection?

Yes. Two ways: (1) Onplana → Integrations → AI agents → tap the token row → Revoke. (2) Unset ONPLANA_PAT in your environment AND run `gemini extensions uninstall onplana`. Either takes effect immediately; the next Gemini tool call returns 401.

What tools does Gemini get access to?

27 tools identical to what Claude Desktop / Cursor / ChatGPT get: reads (list_projects, list_my_tasks, get_task, search_org_knowledge, etc.) and writes (create_task, update_task, assign_task, create_milestone, etc.). The tool catalog is the same regardless of which client is connected. Plan tier gates some tools; the full catalog is at onplana.com/mcp.

Related