---
title: "GreptimeDB MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/greptimedb/
description: "Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking."
---

# GreptimeDB MCP Server: review, setup & limitations · Undominated.ai

> Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.

[← Explore all mcp servers](/mcp-servers/)

DATABASE ANALYTICS / Greptime

# GreptimeDB MCP Server

Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-14
 Evidence 4 linked sources
 Publisher Greptime
 Licence [MIT ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/LICENSE.md)
 Revision 5347e7e38002
 [Read what was—and wasn’t—checked ↓](#review)

“Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.”

 [Greptime · upstream description ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.
- The setup documentation makes this operating boundary explicit: Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.

### A good fit for

 - Query metrics, logs and traces using SQL, TQL and time-window aggregation with result masking.
- Install greptimedb-mcp-server with Python 3.11+; configure GREPTIMEDB_HOST, GREPTIMEDB_DATABASE, user and password. Start stdio with GREPTIMEDB_ALLOW_WRITE=false.

### Weigh up before choosing

 - Masking and statement filtering are application controls, not a replacement for database permissions. Result byte limits can truncate the visible evidence.
- Package/container parity with the pinned source and transitive dependency security were not established.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md
- LICENSE.md
- pyproject.toml
- src/greptimedb_mcp_server/config.py

### Our findings

 - Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.
- Masking and statement filtering are application controls, not a replacement for database permissions. Result byte limits can truncate the visible evidence.

### Not established by this review

 - No server installation, authentication, live tool execution or isolation test was performed.
- Package/container parity with the pinned source and transitive dependency security were not established.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md)

DOCUMENTED COMMAND

 pip install greptimedb-mcp-server Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Install greptimedb-mcp-server with Python 3.11+; configure GREPTIMEDB_HOST, GREPTIMEDB_DATABASE, user and password. Start stdio with GREPTIMEDB_ALLOW_WRITE=false.
- Verify the connected account, available tools and target resource before authorizing mutations.

### Before you start

 - Pinned package Python requirement: >=3.11.
- A compatible local process MCP client.
- Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.

### Compatibility

MCP clients that can launch the documented local process.

### Implementation

Python

### Transports

stdio · Streamable HTTP

### Local process with service or workstation access

 - Use a database user with read grants. Write mode also enables pipeline and dashboard creation/deletion, not just SQL writes.

### Cost model

Publisher service entitlements, API usage and infrastructure charges apply where applicable; the MCP source licence does not include external services.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Pinned publisher README and migration notices ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md) Checked 2026-10-14 https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/README.md Supports: description, setup, capabilities, review, limitations
- [Licence text at the reviewed commit ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/LICENSE.md) Checked 2026-10-14 https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/LICENSE.md Supports: license
- [Pinned package metadata ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/pyproject.toml) Checked 2026-10-14 https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/pyproject.toml Supports: install, language, review
- [Pinned implementation inspected for launch or permission boundary ↗](https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/src/greptimedb_mcp_server/config.py) Checked 2026-10-14 https://github.com/GreptimeTeam/greptimedb-mcp-server/blob/5347e7e380027814fb7b70fc15f08fc380b76d26/src/greptimedb_mcp_server/config.py Supports: review, install, access, limitations

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Apache Doris MCP Server ↗ Explore Doris catalogs, diagnose queries and inspect cluster and ingestion state through bounded read tools.](/mcp-servers/doris/)[### Apache IoTDB MCP Server ↗ Explore IoTDB tree and table models, run SQL and inspect execution permissions and query results.](/mcp-servers/iotdb/)[### SingleStore MCP Server ↗ Inspect SingleStore workspaces and operate database, notebook, job and Stage workflows.](/mcp-servers/singlestore/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
