> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Gemini CLI to Profound MCP

This guide shows you how to connect Gemini CLI to the Profound MCP server, so Gemini can pull your Profound visibility data and run Profound actions directly from the terminal.

## Before you start

Make sure you have:

* [Gemini CLI](https://geminicli.com/) installed
* A [Profound](https://www.tryprofound.com/) account

## Setup guide

<Steps>
  <Step title="Authenticate with Gemini CLI">
    1. Run Gemini CLI in your terminal:
       ```bash theme={null}
       gemini
       ```

    2. When asked **How would you like to authenticate for this project?**, select **Sign in with Google**. Gemini will launch a browser session.

    3. In the browser, select your Google account and sign in.

    If successful, you'll see tips to get started and the command line.

    <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-startup-view.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=76d40e31a87646b8b53c7540d7bcd79c" alt="Gemini CLI startup view screenshot" width="2124" height="772" data-path="images/mcp/gemini-cli-startup-view.png" />
  </Step>

  <Step title="Add the Profound MCP server">
    1. MCP servers are configured in the `~/.gemini/settings.json` configuration file. To add the Profound server, create the `mcpServers` block with the Profound server details in `settings.json`:
       ```json theme={null}
         "mcpServers": {
           "profound": {
             "url": "https://mcp.tryprofound.com/mcp"
           }
         }
       ```
       You can do this in your preferred code editor, or directly from Gemini CLI by entering the prompt:
       ```text theme={null}
       Add an MCP server called profound with url https://mcp.tryprofound.com/mcp
       ```

    2. Review the changes and apply them if the `mcpServers` block looks correct.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-add-server-prompt.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=3fb9455f76c783cecbbfef87b017f109" alt="Gemini CLI screenshot with the prompt to add a new MCP server, a change in settings.json and Apply this change - Allow once option highlighted" width="2118" height="1478" data-path="images/mcp/gemini-cli-add-server-prompt.png" />

    3. For the changes to take effect, quit and reopen your Gemini CLI.

    4. To verify the server was added, run the command to list the MCP servers inside the CLI.

       ```bash theme={null}
         /mcp list
       ```

       It should show `profound` among the configured MCP servers.

           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-server-added.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=c3e025c8441f3ebb942e06ba1bf11905" alt="Gemini CLI screenshot with profound server on the list of configured servers" width="1084" height="331" data-path="images/mcp/gemini-cli-server-added.png" />
  </Step>

  <Step title="Sign in to Profound">
    Profound authenticates with OAuth. Gemini CLI discovers the OAuth endpoints automatically, so no API keys, client ID, or secret are needed.

    1. Inside the CLI, run the command to authenticate with Profound:

       ```bash theme={null}
       /mcp auth profound
       ```

    2. Select **Yes** when asked to authenticate in the browser. This will open the browser to the Profound sign-in page.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-auth-profound.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=ed557cad3e990f807e7046cc7bc02b64" alt="Gemini CLI screenshot with authentication command and an authentication dialog with the Yes option highlighted" width="2114" height="732" data-path="images/mcp/gemini-cli-auth-profound.png" />

    3. If you're not logged in, follow the prompts to log in to your Profound account. Then approve access.
           <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-oauth.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=9a1874de714a746cb59a8224d20439b8" alt="Gemini CLI oauth dialog screenshot with Allow access option highlighted" style={{height: "30em", display: "block", margin: "0 auto"}} width="1182" height="1574" data-path="images/mcp/gemini-cli-oauth.png" />

    When you see the success message, return to the Gemini CLI session in your terminal.
  </Step>

  <Step title="Verify the connection">
    Still inside Gemini CLI, run the MCP list command again.

    ```bash theme={null}
      /mcp list
    ```

    If the Profound server shows as **Ready** with a green circle and has available tools listed, it's connected and ready to go.

    <img src="https://mintcdn.com/profound-37face47/1cWSg0aIvHViHQFW/images/mcp/gemini-cli-profound-ready.png?fit=max&auto=format&n=1cWSg0aIvHViHQFW&q=85&s=5e602e680f2ba3321a39c9b8b9e1923f" alt="Gemini CLI screenshot with an mcp list command ran and profound server listed as ready " width="1382" height="477" data-path="images/mcp/gemini-cli-profound-ready.png" />
  </Step>
</Steps>

<Tip>
  For more details about configuring MCP server connections in Gemini CLI, see Gemini CLI's [MCP server documentation](https://geminicli.com/docs/tools/mcp-server).
</Tip>

## Troubleshooting

### The browser doesn't open during sign-in

Make sure you have a local browser installed. OAuth won't work in headless or remote sessions without browser access. Run the setup where you can open a browser, then retry signing in or authenticating with Profound.

### Profound server shows as disconnected

Re-run `/mcp auth profound` to refresh the token. If it still fails, sign out of Profound in your browser, sign back in, and retry.