Back to search
openobserve
MarketplaceWorks with Claude CodeGitHub
OpenObserve plugin for Claude Code: MCP server and query skill for logs, metrics and traces
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/openobserve--claude-code-plugin)HTML
<a href="/listings/openobserve--claude-code-plugin"><img src="/api/listings/openobserve--claude-code-plugin/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
/plugin marketplace add openobserve/claude-code-plugin /plugin install openobserve@openobserve
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 19 lines
- {
- "name": "openobserve",
- "owner": {
- "name": "OpenObserve",
- "url": "https://openobserve.ai"
- },
- "metadata": {
- "description": "Official OpenObserve plugins for Claude Code"
- },
- "plugins": [
- {
- "name": "openobserve",
- "source": "./",
- "description": "Connect Claude Code to OpenObserve. Guided setup of the MCP server for your cloud region or self-hosted instance, plus skills for SQL and PromQL queries, dashboards, alerts, pipelines, VRL functions and Splunk SPL conversion.",
- "category": "monitoring",
- "homepage": "https://openobserve.ai"
- }
- ]
- }
README.md · README · 75 lines
- # OpenObserve plugin for Claude Code
- Use [OpenObserve](https://openobserve.ai) from Claude Code: query logs, metrics and traces, and work with streams, dashboards and alerts through conversation.
- ## What's included
- | Skill | What it does |
- |---|---|
- | `setup` | Connects Claude Code to the MCP server built into your OpenObserve instance. Asks for your cloud region or self-hosted URL and your organization, checks the endpoint, and registers it. |
- | `sql-query` | Schema-first workflow for writing and validating SQL and PromQL against your streams. |
- | `dashboard-creation` | Builds and edits dashboards: layout grid, chart types, panel JSON, and the panel-level tools. |
- | `alert-creation` | Creates and edits alerts and alert destinations, with sensible defaults. |
- | `pipeline-creation` | Designs data pipelines: source and destination streams, functions and conditions. |
- | `vrl-scripts` | Writes and validates VRL functions for parsing and transforming data. |
- | `spl-conversion` | Converts Splunk SPL searches to OpenObserve SQL. |
- The skills are adapted from the [`@openobserve/skills`](https://www.npmjs.com/package/@openobserve/skills) package (version 1.2.1) for use in Claude Code. That package also has a skill for instrumenting LLM and AI-agent apps, which ships a helper script and so is not part of this plugin.
- ## Install
- ```
- /plugin marketplace add openobserve/claude-code-plugin
- /plugin install openobserve@openobserve
- ```
- ## Connect your instance
- In Claude Code, run:
- ```
- /openobserve:setup
- ```
- or just ask "connect OpenObserve". You will be asked for:
- | Value | Example | Notes |
- |---|---|---|
- | OpenObserve URL | `https://cloud.openobserve.ai` | Cloud: `cloud` (US), `eu1`, `ap1`. Self-hosted: your own host. |
- | Organization ID | `default` | The `org_identifier` shown in the OpenObserve UI address bar. |
- Then run `/mcp`, pick `openobserve`, and sign in. Sign-in uses OAuth in your browser; the plugin stores no credentials.
- To do the same by hand:
- ```
- claude mcp add --transport http --scope user openobserve https://<host>/api/<org_id>/mcp
- ```
- ## What the skills can run
- - `setup` runs `claude mcp list`, one unauthenticated `curl` probe of the endpoint you name, and `claude mcp add`.
- - The other skills only call OpenObserve MCP tools.
- ## Why the server is not bundled
- Every OpenObserve organization has its own MCP address (`<host>/api/<org_id>/mcp`), and self-hosted instances live on their own hosts, so there is no single URL a plugin could ship. The setup skill registers your endpoint as an ordinary user-level MCP server, which you can inspect or remove with `claude mcp list` and `claude mcp remove openobserve`.
- ## Permissions
- The MCP server acts with the permissions of the signed-in user. It is **not read-only**: besides search, it exposes tools that create, update and delete dashboards, alerts and other resources. Claude Code asks before each tool call unless you allow it; use a role with read-only access if you want to rule out changes.
- ## Local development
- ```
- claude plugin validate .
- claude --plugin-dir .
- ```
- ## Privacy
- The plugin talks only to the OpenObserve instance you configure. See the [OpenObserve privacy policy](https://openobserve.ai/legal/privacy-policy/).
- ## License
- Apache-2.0
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.