{"id":31830831,"url":"https://github.com/gemini-cli-extensions/looker","last_synced_at":"2026-03-02T17:03:38.025Z","repository":{"id":316317969,"uuid":"1055658811","full_name":"gemini-cli-extensions/looker","owner":"gemini-cli-extensions","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-30T22:39:43.000Z","size":51,"stargazers_count":6,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-01T00:23:42.049Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gemini-cli-extensions.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-12T15:43:39.000Z","updated_at":"2025-09-30T22:39:44.000Z","dependencies_parsed_at":"2025-09-28T11:00:44.270Z","dependency_job_id":null,"html_url":"https://github.com/gemini-cli-extensions/looker","commit_stats":null,"previous_names":["gemini-cli-extensions/looker"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/gemini-cli-extensions/looker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Flooker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Flooker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Flooker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Flooker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gemini-cli-extensions","download_url":"https://codeload.github.com/gemini-cli-extensions/looker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gemini-cli-extensions%2Flooker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008855,"owners_count":26084517,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-11T21:26:07.506Z","updated_at":"2026-03-02T17:03:38.010Z","avatar_url":"https://github.com/gemini-cli-extensions.png","language":null,"funding_links":[],"categories":["Data \u0026 Analytics"],"sub_categories":["Observability \u0026 Monitoring"],"readme":"# Gemini CLI Extension - Looker\n\n\u003e [!NOTE]\n\u003e 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\u003e [!IMPORTANT]\n\u003e **We Want Your Feedback!**\n\u003e Please share your thoughts with us by filling out our feedback [form][form]. \n\u003e 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\u0026entry.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* [Gemini CLI](https://github.com/google-gemini/gemini-cli) installed with version **+v0.6.0**.\n* Setup Gemini CLI [Authentication](https://github.com/google-gemini/gemini-cli/tree/main?tab=readme-ov-file#-authentication-options).\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). If you don't have access to the Admin pages of the Looker system, you will need to ask your administrator to get the Id and Secret for you.\n\n## Getting Started\n\n### Installation\n\nTo install the extension, use the command:\n\n```bash\ngemini extensions install https://github.com/gemini-cli-extensions/looker\n```\n\n### Configuration\n\nYou will be prompted to configure the following settings during installation. These settings are saved in an `.env` file within the extension's directory.\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_VERIFY_SSL`: (Optional) Whether to verify SSL certificates. Defaults to `true`.\n*   `LOOKER_SHOW_HIDDEN_MODELS`: (Optional) Whether to show hidden models. Defaults to `true`.\n*   `LOOKER_SHOW_HIDDEN_EXPLORES`: (Optional) Whether to show hidden explores. Defaults to `true`.\n*   `LOOKER_SHOW_HIDDEN_FIELDS`: (Optional) Whether to show hidden fields. Defaults to `true`.\n\nTo view or update your configuration:\n\n**List Settings:**\n*   Terminal: `gemini extensions list`\n*   Gemini CLI: `/extensions list`\n\n**Update Settings:**\n*   Terminal: `gemini extensions config looker [setting name] [--scope \u003cscope\u003e]`\n    *   `setting name`: (Optional) The single setting to configure.\n    *   `scope`: (Optional) The scope of the setting in (`user` or `workspace`). Defaults to `user`.\n*   Currently, you must restart the Gemini CLI for changes to take effect. We recommend using `gemini --resume` to resume your session.\n\nAlternatively, you can manually set these environment variables before starting the Gemini CLI:\n\n```bash\nexport LOOKER_BASE_URL=\"\u003cyour-looker-instance-url\u003e\"  # e.g. `https://looker.example.com`. You may need to add the port, i.e. `:19999`.\nexport LOOKER_CLIENT_ID=\"\u003cyour-looker-client-id\u003e\"\nexport LOOKER_CLIENT_SECRET=\"\u003cyour-looker-client-secret\u003e\"\nexport LOOKER_VERIFY_SSL=\"true\" # Optional, defaults to true\nexport LOOKER_SHOW_HIDDEN_MODELS=\"true\" # Optional, defaults to true\nexport LOOKER_SHOW_HIDDEN_EXPLORES=\"true\" # Optional, defaults to true\nexport LOOKER_SHOW_HIDDEN_FIELDS=\"true\" # Optional, defaults to true\n```\n\n\u003e [!NOTE]\n\u003e * 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*?\n3. What measures and dimensions are in *explore_name*?\n4. Using *model_name*, what is the total revenue in 2025? Break that\n   down by month and pivot by product category.\n5. What is the sql for that last query?\n6. Visualize that data using a stacked column chart and give me the url to it.\n7. Save that as a Look.\n8. Run the Look titled \"Revenue Projection\".\n9. Create a dashboard analyzing sales for the year 2025.\n\n## Supported Tools\n\nThe full tool list is available in the [Prebuilt Tools Reference](https://googleapis.github.io/genai-toolbox/reference/prebuilt-tools/#looker).\n\nThe following tools are available to the LLM:\n\n### Looker Model and Query Tools\n\nThese tools are used to get information about a Looker model\nand execute queries against that model.\n\n1. **get_models**: list the LookML models in Looker\n1. **get_explores**: list the explores in a given model\n1. **get_dimensions**: list the dimensions in a given explore\n1. **get_measures**: list the measures in a given explore\n1. **get_filters**: list the filters in a given explore\n1. **get_parameters**: list the parameters in a given explore\n1. **query**: Run a query and return the data\n1. **query_sql**: Return the SQL generated by Looker for a query\n1. **query_url**: Return a link to the query in Looker for further exploration\n\n### Looker Content Tools\n\nThese tools get saved content (Looks and Dashboards) from a Looker\ninstance and create new saved content.\n\n1. **get_looks**: Return the saved Looks that match a title or description\n1. **run_look**: Run a saved Look and return the data\n1. **make_look**: Create a saved Look in Looker and return the URL\n1. **get_dashboards**: Return the saved dashboards that match a title or description\n1. **run_dashboard**: Run a saved dashboard and return the data\n1. **make_dashboard**: Create a saved dashboard in Looker and return the URL\n1. **add_dashboard_filter**: Add a filter to a dashboard\n1. **add_dashboard_element**: Add a tile to a dashboard\n\n### Looker Instance Health Tools\n\nThese tools offer the same health check algorithms that the popular\nCLI [Henry](https://github.com/looker-open-source/henry) offers.\n\n1. **health_pulse**: Check the health of a Looker intance\n1. **health_analyze**: Analyze the usage of a Looker object\n1. **health_vacuum**: Find LookML elements that might be unused\n\n### LookML Authoring Tools\n\nThese tools allow enable the caller to write and modify LookML files\nas well as get the database schema needed to write LookML effectively.\n\n1. **dev_mode**: Activate dev mode.\n1. **get_projects**: Get the list of LookML projects\n1. **get_project_files**: Get the list of files in a project\n1. **get_project_file**: Get the contents of a file in a project\n1. **create_project_file**: Create a file in a project\n1. **update_project_file**: Update the contents of a file in a project\n1. **delete_project_file**: Delete a file in a project\n1. **validate_project**: Validate a project\n1. **get_connections**: Get the list of connections\n1. **get_connection_schemas**: Get the list of schemas for a connection\n1. **get_connection_databases**: Get the list of databases for a connection\n1. **get_connection_tables**: Get the list of tables for a connection\n1. **get_connection_table_columns**: Get the list of columns for a table in a connection\n\n### Developer Tools\n\n1. **generate_embed_url**: Generate an embed url for content.\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* \"✖ 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 /Users/USER/.gemini/extensions/cloud-sql-sqlserver/toolbox ENOENT\": The Toolbox binary did not download correctly. Ensure you are using Gemini CLI v0.6.0+.\n* \"cannot execute binary file\": The Toolbox binary did not download correctly. Ensure the correct binary for your OS/Architecture has been downloaded. See [Installing the server](https://googleapis.github.io/genai-toolbox/getting-started/introduction/#installing-the-server) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgemini-cli-extensions%2Flooker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgemini-cli-extensions%2Flooker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgemini-cli-extensions%2Flooker/lists"}