Gemini CLI

Gemini CLI is Google’s command-line AI assistant. You can connect it to Kavio’s MCP server to manage your social media scheduling with natural language.

Prerequisites

Gemini CLI installed
A Kavio account with an active trial or subscription (no card required to start)

Setup

Open the settings file

Edit your Gemini CLI settings at ~/.gemini/settings.json:

{
  "mcpServers": {
    "kavio": {
      "httpUrl": "https://app.getkavio.app/mcp/kavio",
      "oauth": {
        "enabled": true
      }
    }
  }
}

With oauth.enabled, Gemini CLI discovers Kavio’s OAuth metadata from the URL and registers dynamically. For project-level configuration, create .gemini/settings.json in your project root instead.

Restart Gemini CLI and sign in

Close and reopen Gemini CLI. The first Kavio call prompts you to sign in — Gemini CLI prints the authorize URL or opens your browser. Approve and return to the terminal.

Verify the connection

Ask Gemini to interact with your Kavio account:

List all my Kavio posts

Gemini CLI uses "httpUrl" for HTTP-streaming servers (not "url"). The "url" field is used for SSE transport only.

Bearer token fallback

For headless environments, use a Personal Access Token instead of OAuth:

{
  "mcpServers": {
    "kavio": {
      "httpUrl": "https://app.getkavio.app/mcp/kavio",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Create the key from Settings > API Keys on the Kavio dashboard.

Example prompts

Create a new signature called "Growth Hacking"

What workspace am I connected to?

Show me all my labels

Getting Started

Setup Guides

Prerequisites

Setup

Example prompts

​Prerequisites

​Setup

​Example prompts

Prerequisites

Setup

Example prompts