Skip to content
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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/openobserve--claude-code-plugin/badge.svg)](/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
  1. {
  2. "name": "openobserve",
  3. "owner": {
  4. "name": "OpenObserve",
  5. "url": "https://openobserve.ai"
  6. },
  7. "metadata": {
  8. "description": "Official OpenObserve plugins for Claude Code"
  9. },
  10. "plugins": [
  11. {
  12. "name": "openobserve",
  13. "source": "./",
  14. "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.",
  15. "category": "monitoring",
  16. "homepage": "https://openobserve.ai"
  17. }
  18. ]
  19. }
README.md · README · 75 lines
  1. # OpenObserve plugin for Claude Code
  2. Use [OpenObserve](https://openobserve.ai) from Claude Code: query logs, metrics and traces, and work with streams, dashboards and alerts through conversation.
  3. ## What's included
  4. | Skill | What it does |
  5. |---|---|
  6. | `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. |
  7. | `sql-query` | Schema-first workflow for writing and validating SQL and PromQL against your streams. |
  8. | `dashboard-creation` | Builds and edits dashboards: layout grid, chart types, panel JSON, and the panel-level tools. |
  9. | `alert-creation` | Creates and edits alerts and alert destinations, with sensible defaults. |
  10. | `pipeline-creation` | Designs data pipelines: source and destination streams, functions and conditions. |
  11. | `vrl-scripts` | Writes and validates VRL functions for parsing and transforming data. |
  12. | `spl-conversion` | Converts Splunk SPL searches to OpenObserve SQL. |
  13. 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.
  14. ## Install
  15. ```
  16. /plugin marketplace add openobserve/claude-code-plugin
  17. /plugin install openobserve@openobserve
  18. ```
  19. ## Connect your instance
  20. In Claude Code, run:
  21. ```
  22. /openobserve:setup
  23. ```
  24. or just ask "connect OpenObserve". You will be asked for:
  25. | Value | Example | Notes |
  26. |---|---|---|
  27. | OpenObserve URL | `https://cloud.openobserve.ai` | Cloud: `cloud` (US), `eu1`, `ap1`. Self-hosted: your own host. |
  28. | Organization ID | `default` | The `org_identifier` shown in the OpenObserve UI address bar. |
  29. Then run `/mcp`, pick `openobserve`, and sign in. Sign-in uses OAuth in your browser; the plugin stores no credentials.
  30. To do the same by hand:
  31. ```
  32. claude mcp add --transport http --scope user openobserve https://<host>/api/<org_id>/mcp
  33. ```
  34. ## What the skills can run
  35. - `setup` runs `claude mcp list`, one unauthenticated `curl` probe of the endpoint you name, and `claude mcp add`.
  36. - The other skills only call OpenObserve MCP tools.
  37. ## Why the server is not bundled
  38. 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`.
  39. ## Permissions
  40. 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.
  41. ## Local development
  42. ```
  43. claude plugin validate .
  44. claude --plugin-dir .
  45. ```
  46. ## Privacy
  47. The plugin talks only to the OpenObserve instance you configure. See the [OpenObserve privacy policy](https://openobserve.ai/legal/privacy-policy/).
  48. ## License
  49. Apache-2.0

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.