Documentation Index
Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
Use this file to discover all available pages before exploring further.
Looker is a Google Cloud business intelligence platform for data exploration and visualization. The Looker MCP server lets you manage dashboards, run queries, explore LookML models, schedule deliveries, and monitor alerts using natural language.
What Can It Do?
- Manage dashboards by listing, creating, updating, and deleting dashboards and their elements
- Work with Looks to create, run, and manage saved queries
- Run queries inline or from saved definitions, with async task support
- Explore LookML models and their dimensions, measures, and relationships
- Schedule deliveries for reports and dashboards
- Manage alerts for threshold-based notifications
- Organize content with folders, boards, favorites, and metadata
- Render dashboards and Looks as downloadable images or PDFs
Where to Use It
In Agents (Recommended)
Add Looker as a tool to any agent. The agent can then access your dashboards and analytics conversationally, choosing the right actions based on context.
To add an MCP tool to your agent:
- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with Looker tools. This gives you the flexibility of an agent within a deterministic workflow.
As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Run the monthly sales dashboard query”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
Setting Up Credentials
Looker uses API3 client credentials for authentication. You’ll need:
- A Looker Enterprise instance with API access enabled
- A dedicated service account Client ID and Client Secret (generated in Looker Admin → Users → API Keys)
- Your Looker API Host URL (e.g.,
https://company.cloud.looker.com)
Add these credentials to your Gumloop credentials.
Dashboards
| Tool | Description |
|---|
| List Dashboards | Search Looker dashboards |
| Get Dashboard | Get a Looker dashboard |
| Create Dashboard | Create a Looker dashboard |
| Update Dashboard | Update a Looker dashboard |
| Delete Dashboard | Delete a Looker dashboard |
| Move or Copy Content | Move or copy a dashboard or Look |
Dashboard Elements
| Tool | Description |
|---|
| List Dashboard Elements | Search dashboard tiles |
| Create Dashboard Element | Create a dashboard tile |
| Update Dashboard Element | Update a dashboard tile |
| Delete Dashboard Element | Delete a dashboard tile |
| Create Dashboard Filter | Create a dashboard filter |
| Update Dashboard Filter | Update a dashboard filter |
| Delete Dashboard Filter | Delete a dashboard filter |
Looks
| Tool | Description |
|---|
| List Looks | Search Looker Looks |
| Get Look | Get a Looker Look |
| Create Look | Create a Looker Look |
| Update Look | Update a Looker Look |
| Delete Look | Delete a Looker Look |
| Run Look | Run a Looker Look |
Queries
| Tool | Description |
|---|
| Run Query | Run a saved Looker query |
| Run Inline Query | Run an inline Looker query |
| Create Query | Create a Looker query |
| Get Query | Get a Looker query |
| Create Query Task | Create an async Looker query task |
| Get Query Task | Get a Looker query task |
| Get Query Task Results | Get Looker query task results |
Rendering
| Tool | Description |
|---|
| Create Dashboard Render Task | Create a dashboard render task |
| Create Look Render Task | Create a Look render task |
| Get Render Task | Get a Looker render task |
| Get Render Task Results | Get Looker render task results |
LookML
| Tool | Description |
|---|
| List LookML Models | List LookML models |
| Get LookML Model | Get a LookML model |
| Get LookML Model Explore | Get a LookML explore |
Folders & Content
| Tool | Description |
|---|
| List Folders | Search Looker folders |
| Get Folder | Get a Looker folder |
| Create Folder | Create a Looker folder |
| Update Folder | Update a Looker folder |
| Delete Folder | Delete a Looker folder |
| Search Content | Search Looker content |
| List Content Favorites | Search content favorites |
| Create Content Favorite | Favorite Looker content |
| Delete Content Favorite | Remove a content favorite |
| Get Content Metadata | Get Looker content metadata |
| Update Content Metadata | Update Looker content metadata |
| Validate Content | Run Looker content validation |
Boards
| Tool | Description |
|---|
| List Boards | List Looker boards |
| Get Board | Get a Looker board |
| Create Board | Create a Looker board |
| Update Board | Update a Looker board |
| Delete Board | Delete a Looker board |
| Create Board Section | Create a board section |
| Update Board Section | Update a board section |
| Delete Board Section | Delete a board section |
| Create Board Item | Create a board item |
| Update Board Item | Update a board item |
| Delete Board Item | Delete a board item |
Scheduled Plans & Delivery
| Tool | Description |
|---|
| List Scheduled Plans | List Looker scheduled plans |
| Get Scheduled Plan | Get a scheduled plan |
| Create Scheduled Plan | Create a scheduled plan |
| Update Scheduled Plan | Update a scheduled plan |
| Delete Scheduled Plan | Delete a scheduled plan |
| Run Scheduled Plan Once | Run a scheduled plan once |
Alerts
| Tool | Description |
|---|
| List Alerts | Search Looker alerts |
| Get Alert | Get a Looker alert |
| Create Alert | Create a Looker alert |
| Update Alert | Update a Looker alert |
| Delete Alert | Delete a Looker alert |
Example Prompts
Use these with your agent or in the Agent Node:
List dashboards:
Show me all dashboards that contain "revenue" in the title
Run the "Monthly Sales Summary" Look and show me the results
Run a query on the orders explore showing total revenue by region for this quarter
What dimensions and measures are available in the orders explore?
Create a scheduled plan to email the Sales Dashboard every Monday at 9am
Move the Q4 dashboard to the Finance folder
Generate a PDF export of the Executive Summary dashboard
Show me all active alerts for the revenue metrics
Troubleshooting
| Issue | Solution |
|---|
| Authentication failed | Verify your Client ID and Client Secret are correct and the service account has API access |
| Dashboard not found | Use exact dashboard titles or IDs. Try listing dashboards first to find the correct reference. |
| Query timeout | Large queries may take time. Use async query tasks for complex queries. |
| Permission denied | Ensure the service account has the appropriate Looker role and model access |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Agents are smart enough to chain multiple API calls together. For example, asking “Show me last month’s revenue trend” will find the right Look or explore, run the query, and present the results. If results seem off, check the agent’s step-by-step reasoning.
Need Help?
Use this integration directly in Claude or Cursor. Connect remotely via the Looker MCP server using your Gumloop credentials.
