{
  "markdown": "# Gemini CLI Extension - Looker Conversational Analytics\n\n> [!NOTE]\n> This extension is currently in beta (pre-v1.0), and may see breaking changes until the first stable release (v1.0).\n\nThis Gemini CLI extension provides a set of tools to interact with [Looker](https://cloud.google.com/looker/docs) instances. It allows you to manage your Looks, dashboards, and explores directly from the [Gemini CLI](https://google-gemini.github.io/gemini-cli/), using natural language prompts.\n\nLearn more about [Gemini CLI Extensions](https://github.com/google-gemini/gemini-cli/blob/main/docs/extensions/index.md).\n> [!IMPORTANT]\n> **We Want Your Feedback!**\n> Please share your thoughts with us by filling out our feedback [form][form]. \n> Your input is invaluable and helps us improve the project for everyone.\n\n[form]: https://docs.google.com/forms/d/e/1FAIpQLSfEGmLR46iipyNTgwTmIDJqzkAwDPXxbocpXpUbHXydiN1RTw/viewform?usp=pp_url&entry.157487=looker\n\n## Why Use the Looker Extension?\n\n* **Seamless Workflow:** Stay in your CLI. No need to constantly switch contexts.\n* **Connect to Looker:** Securely connect to your Looker instances.\n* **Natural Language Usage:** Stop wrestling with complex commands. List models, explores, and dimensions, and run Looks and queries by describing what you want in plain English.\n\n\n## Prerequisites\n\nBefore you begin, ensure you have the following:\n\n* One of the supported agent harnesses, installed and authenticated:\n  * [Gemini CLI](https://github.com/google-gemini/gemini-cli) (v0.6.0+)\n  * [Claude Code](https://code.claude.com)\n  * [Codex](https://developers.openai.com/codex) (v0.150.0+)\n  * [Antigravity CLI](https://antigravity.google)\n* [Node.js](https://nodejs.org/) (the MCP server runs via `npx`).\n* A Looker instance with API access enabled.\n    You will need a Looker Client Id and Client Secret. These can be obtained by following the directions at [Looker API authentication](https://cloud.google.com/looker/docs/api-auth#authentication_with_an_sdk).\n\n* A Google Cloud project with the appropriate APIs enabled.\n    You will need a Google Cloud project with the appropriate APIS enabled. Use the following command to enable those APIs:\n    ```\n    gcloud services enable geminidataanalytics.googleapis.com --project=$PROJECT_ID\n    gcloud services enable cloudaicompanion.googleapis.com --project=$PROJECT_ID\n    ```\n\n    In addition to [setting the ADC for your server][set-adc], you need to ensure the IAM identity has been given the following IAM roles (or corresponding permissions):\n    - `roles/looker.instanceUser`\n    - `roles/cloudaicompanion.user`\n    - `roles/geminidataanalytics.dataAgentStatelessUser`\n\n    To initialize the application default credential run `gcloud auth login --update-adc` in your environment before starting MCP Toolbox.\n\n[set-adc]: https://cloud.google.com/docs/authentication/provide-credentials-adc\n\n\n## Getting Started\n\n### Installation\n\nAll harnesses use the same plugin; the MCP server runs via `npx` (no binary to download). Install with your harness of choice:\n\n**Gemini CLI**\n\n```bash\ngemini extensions install https://github.com/gemini-cli-extensions/looker-conversational-analytics\n```\n\n**Claude Code**\n\n```bash\nclaude plugin marketplace add gemini-cli-extensions/looker-conversational-analytics\nclaude plugin install looker-conversational-analytics@looker-conversational-analytics\n```\n\n**Codex**\n\n```bash\ncodex plugin marketplace add gemini-cli-extensions/looker-conversational-analytics\ncodex plugin add looker-conversational-analytics@looker-conversational-analytics\n```\n\n**Antigravity**\n\n```bash\nagy plugin install https://github.com/gemini-cli-extensions/looker-conversational-analytics\n```\n\nSee [Configuration](#configuration) for how each harness supplies the connection settings.\n\n### Configuration\n\nThe plugin connects to Looker using these settings:\n\n*   `LOOKER_BASE_URL`: The URL of your Looker instance (e.g. `https://looker.example.com`). You may need to add the port, i.e. `:19999`.\n*   `LOOKER_CLIENT_ID`: Your Looker Client ID.\n*   `LOOKER_CLIENT_SECRET`: Your Looker Client Secret.\n*   `LOOKER_PROJECT`: The Google Cloud Project ID.\n*   `LOOKER_LOCATION`: The Google Cloud Location ID.\n*   `LOOKER_VERIFY_SSL`: (Optional) Whether to verify SSL certificates. Defaults to `true`.\n\nHow you supply them depends on the harness:\n\n*   **Gemini CLI**: prompted on install and saved to the extension's `.env`. View or update later with `gemini extensions list` / `gemini extensions config looker-conversational-analytics [setting] [--scope user|workspace]` (restart the CLI to apply).\n*   **Claude Code**: pass `--config KEY=VALUE` on install (repeatable), or run `/plugin` inside Claude Code.\n*   **Codex** and **Antigravity**: export the variables in your shell before starting:\n\n```bash\nexport LOOKER_BASE_URL=\"<your-looker-instance-url>\"  # e.g. `https://looker.example.com`. You may need to add the port, i.e. `:19999`.\nexport LOOKER_CLIENT_ID=\"<your-looker-client-id>\"\nexport LOOKER_CLIENT_SECRET=\"<your-looker-client-secret>\"\nexport LOOKER_PROJECT=\"<your-google-cloud-project-id>\"\nexport LOOKER_LOCATION=\"<your-google-cloud-location-id>\"\nexport LOOKER_VERIFY_SSL=\"true\" # Optional, defaults to true\n```\n\n> [!NOTE]\n> * Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment.\n> * See [Troubleshooting](#troubleshooting) for debugging your configuration.\n\n### Start Gemini CLI\n\nTo start the Gemini CLI, use the following command:\n\n```bash\ngemini\n```\n\n## Usage\nYou can ask questions and give commands such as these:\n\n1. What models are available in my Looker instance?\n2. What explores are available in *model_name*?\n2. What questions can I ask of the explore *explore_name* in model *model_name*?\n\n## Supported Tools\n\n* `get_models`: Use this tool to list the LookML models in Looker.\n* `get_explores`: Use this tool to list the explores in a given model.\n* `ask_data_insights`: Use this tool to ask a natural language questions of an explore.\n\n## Additional Extensions\n\nFind additional extensions to support your entire software development lifecycle at [github.com/gemini-cli-extensions](https://github.com/gemini-cli-extensions).\n\n## Troubleshooting\n\nUse `gemini --debug` to enable debugging.\n\nCommon issues:\n\n* \"failed to find default credentials: google: could not find default credentials.\": Ensure [Application Default Credentials](https://cloud.google.com/docs/authentication/gcloud) are available in your environment. See [Set up Application Default Credentials](https://cloud.google.com/docs/authentication/external/set-up-adc) for more information.\n* \"✖ Error during discovery for server: MCP error -32000: Connection closed\": The database connection has not been established. Ensure your configuration is set via environment variables.\n* \"✖ MCP ERROR: Error: spawn npx ENOENT\": Node.js/`npx` is not installed or not on your `PATH`. Install Node.js (which provides `npx`).\n* \"npm error\"/network failures on first run: `npx` fetches `@toolbox-sdk/server` on first launch, so it needs network access. Retry once connectivity is available.\n",
  "bytes": 7123,
  "sha": "ab0b683db9e283ef8bc2b9f1250feda7474c4c07f6bc77c95aec57cd4925e35d",
  "repo_slug": "gemini-cli-extensions/looker-conversational-analytics",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gemini_cli_extensions_looker_conversatio_2927047a/readme"
}