---
id: grafana-client
version: "5.1.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# grafana-client — A client library for accessing the Grafana HTTP API, written in Python

License: permissive · Maintenance: active · Downloads: 191.1K/mo

## What it is and what it does

grafana-client is a Python wrapper around the Grafana HTTP API that lets you automate Grafana administration and dashboard management from code. It provides both synchronous and asynchronous interfaces to create, update, and delete dashboards; manage users, teams, and organizations; configure data sources; and handle permissions and alerts. The library handles authentication via API tokens, HTTP Basic Auth, header-based auth, or anonymous access, and supports custom DNS resolution and HTTP proxies through its underlying niquests dependency.

The package covers most of the Grafana API surface—admin operations, dashboards, data sources, folders, teams, users, annotations, snapshots, and plugins are fully supported, while some subsystems like alerting and RBAC have partial support. It includes client-side data source health checks for Grafana 7+ and works with Python 3.7 through 3.14, making it suitable for monitoring automation, infrastructure-as-code workflows, and programmatic dashboard provisioning.

Use it for:

- Automate dashboard creation and updates as part of infrastructure-as-code or CI/CD pipelines.
- Programmatically manage Grafana users, teams, and organization membership in multi-tenant environments.
- Build monitoring automation scripts that create alerts, configure data sources, and set up dashboards without manual UI interaction.
- Integrate Grafana provisioning into deployment workflows to ensure consistent monitoring setups across environments.
- Perform bulk operations like exporting dashboards, managing permissions, or syncing external groups via the Admin API.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for the Grafana HTTP API, supporting both synchronous and asynchronous operations to manage dashboards, users, teams, data sources, and other Grafana resources.

Yes. grafana-client is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It covers the majority of the Grafana API with both sync and async support, making it the standard choice for Grafana automation in Python. Install it if you need to programmatically manage Grafana resources.

## Install

pip install grafana-client
uv add grafana-client
poetry add grafana-client

## Installing grafana-client

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with recent commits and a stable release cycle. Depends on niquests, importlib-metadata, and verlib2—all lightweight runtime dependencies.

License in practice: MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart:

pip install grafana-client

from grafana_client import GrafanaApi

grafana = GrafanaApi.from_url("https://username:password@grafana.example.org/grafana/")
user = grafana.admin.create_user({"name": "User", "email": "user@example.org", "login": "user", "password": "pass", "OrgId": 1})

Verify before relying:

- Whether all Grafana versions 5.x–13.x are equally well-supported or if certain API subsystems have version-specific limitations beyond the documented +/+- status indicators.
- Performance characteristics under high concurrency with the async API, particularly with custom session pool sizes.
- Whether the client-side data source health check implementation for Grafana <9 has feature parity with the server-side API in Grafana 9+.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 191.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

grafana api client, grafana dashboard automation, grafana http client, grafana user management, grafana python sdk, grafana rest api wrapper, grafana async client, grafana-automation, async-support, infrastructure-as-code

[View on SkillFed](https://skillfed.io/packages/grafana-client) · [View on PyPI](https://pypi.org/project/grafana-client/)