Updated March 2026

Install OpenObserve Community

Pick your client, copy the command, done.

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add -e "OO_BASE_URL=${OO_BASE_URL}" -e "OO_AUTH_MODE=${OO_AUTH_MODE}" openobserve-community -- uvx --from openobserve-community-mcp openobserve-mcp
Required:OO_BASE_URLOO_AUTH_MODE+ 4 optional

Environment Variables

Set these before running OpenObserve Community.

VariableDescriptionRequired
OO_BASE_URLThe base URL of your OpenObserve instanceYes
OO_AUTH_MODEAuthentication mode (e.g., basic)Yes
OO_USERNAMEUsername for basic authenticationNo
OO_PASSWORDPassword for basic authenticationNo
OO_TOKENBearer token for authenticationNo
OO_ORG_IDOrganization ID if not using the defaultNo

Available Tools (8)

Once configured, OpenObserve Community gives your AI agent access to:

list_streamsLists all available streams in the OpenObserve instance.
get_stream_schemaRetrieves the schema for a specific stream.
search_logsPerforms a search query across logs.
search_aroundSearches for logs around a specific timestamp or event.
search_valuesSearches for specific values within the logs.
list_dashboardsLists all available dashboards.
get_dashboardRetrieves the configuration and details of a specific dashboard.
get_latest_tracesFetches the most recent traces from the system.

Try It Out

After setup, try these prompts with your AI agent:

→List all the available log streams in my OpenObserve instance.
→Search the logs for any errors that occurred in the last hour.
→Get the schema for the 'application-logs' stream.
→Show me the latest traces to identify recent performance bottlenecks.
→List all my dashboards and get the details for the 'System Overview' dashboard.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • OO_BASE_URL — The base URL of your OpenObserve instance
  • OO_AUTH_MODE — Authentication mode (e.g., basic)
Alternative installation methods

Global Install

uv tool install openobserve-community-mcp

Keep this setup from going cold

Save the docs, env vars, and workflow around OpenObserve Community in Conare so Claude Code, Codex, and Cursor remember it next time.

Need the legacy visual installer? Open Conare IDE.
Remember this setup
← OpenObserve Community overview Browse monitoring servers →