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

# Gemini CLI

> Connect VMEG Remote MCP in Gemini CLI

Add VMEG to Gemini CLI and translate media from natural-language prompts in your terminal.

<h2 id="manual-setup">
  Manual setup
</h2>

### Prerequisites

* Gemini CLI installed (`npm install -g @google/gemini-cli@latest`)
* A VMEG account — see [Pricing](/guides/pricing) for credits
* An [API Key](https://www.vmeg.ai/open-api-setting) from API Configuration

### Add the MCP server

Edit your Gemini CLI settings and add VMEG under `mcpServers`:

* **Global (all projects):** `~/.gemini/settings.json`
* **Project-scoped:** `.gemini/settings.json` in your project root

```json theme={null}
{
  "mcpServers": {
    "vmeg": {
      "httpUrl": "https://www.vmeg.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

Replace `YOUR_API_KEY` with your key from [API Configuration](https://www.vmeg.ai/open-api-setting). If you already have other MCP servers, add `vmeg` alongside them. Restart Gemini CLI after saving.

### Verify

Launch Gemini CLI and run:

```text theme={null}
/mcp
```

`vmeg` should appear with its available tools.

### Usage

```text theme={null}
Translate demo.mp4 to Korean with VMEG.
```

## Configuration scoping

| Scope   | File location                          | Availability         |
| ------- | -------------------------------------- | -------------------- |
| Global  | `~/.gemini/settings.json`              | All projects         |
| Project | `.gemini/settings.json` (project root) | Current project only |

<h2 id="app-marketplace">
  App marketplace
</h2>

<Note>
  One-click Gemini CLI integration is **coming soon**. Use [manual setup](#manual-setup) above for now.
</Note>