View as Markdown
Grafana icon

Grafana ACTION

Search Dashboards

Search for dashboards by title, tag, or folder. Returns dashboard UIDs, titles, URLs, tags, and folder info. Use the UID with Get Dashboard to retrieve the full dashboard model. Use List Folders to discover folder UIDs for filtering.
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Grafana account once, then configure and run Search Dashboards from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "grafana-search-dashboards",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    grafana: { authProvisionId: "apn_xxxxxxx" },
    query: "Query",
    tag: ["Tags"],
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Dashboards inputs
Property Type Description
query Query string
Search dashboards by title. Partial matches supported.
Optional
tag Tags string[]
Filter dashboards by tags. Returns dashboards matching any of the specified tags.
Optional
folderUids Folder UIDs string[]
Filter by folder UIDs. Use List Folders to discover available folders.
Optional
type Type string
Filter by type. dash-db for dashboards, dash-folder for folders.
Optional
limit Limit integer
Maximum number of results. Default: 100.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
grafana-search-dashboards
Version
0.0.3
App
Grafana
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes