Kibana MCP Server

Access and interact with your Kibana instance using natural language or programmatic requests.

GitHub
84
Try this MCPSponsored

Documentation

MseeP.ai Security Assessment Badge

Kibana MCP Server

npm version Downloads Ask DeepWiki

A Kibana MCP server implementation that allows any MCP-compatible client (such as Claude Desktop) to access your Kibana instance via natural language or programmatic requests.

This project is based on the official Elastic Kibana API documentation and uses the OpenAPI YAML specification from Elastic Stack 8.x. For details, see the Kibana API documentation.

This project is community-maintained and is not an official product of Elastic or MCP.

💡 Companion Project: For complete Elastic Stack integration, pair this with Elasticsearch MCP Server for direct Elasticsearch data operations.

🚀 Installation

# Global installation (recommended)
npm install -g @tocharianou/mcp-server-kibana

# Or use directly with npx
npx @tocharianou/mcp-server-kibana

From Source

git clone https://github.com/TocharianOU/mcp-server-kibana.git
cd mcp-server-kibana
npm install && npm run build

🎯 Quick Start

Claude Desktop Integration (Recommended)

Add to your Claude Desktop configuration file:

  • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "kibana": {
      "command": "npx",
      "args": ["@tocharianou/mcp-server-kibana"],
      "env": {
        "KIBANA_URL": "http://your-kibana-server:5601",
        "KIBANA_API_KEY": "your-api-key",
        "KIBANA_DEFAULT_SPACE": "default"
      }
    }
  }
}

Direct CLI Usage

# Using API Key (recommended)
KIBANA_URL=http://localhost:5601 \
KIBANA_API_KEY=your-api-key \
npx @tocharianou/mcp-server-kibana

# Using Basic Auth
KIBANA_URL=http://localhost:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
npx @tocharianou/mcp-server-kibana

# Using Cookie Auth
KIBANA_URL=http://localhost:5601 \
KIBANA_COOKIES="sid=xxx; security-session=yyy" \
npx @tocharianou/mcp-server-kibana

HTTP Mode (Remote Access)

MCP_TRANSPORT=http \
MCP_HTTP_PORT=3000 \
KIBANA_URL=http://localhost:5601 \
KIBANA_API_KEY=your-api-key \
npx @tocharianou/mcp-server-kibana

Access at: http://localhost:3000/mcp
Health check: http://localhost:3000/health

✨ Features

Core Capabilities

  • Dual transport modes: Stdio (local) and HTTP (remote access)
  • Multiple authentication methods: API Key, Basic Auth, Cookie-based
  • Multi-space support: Enterprise-ready Kibana space management
  • SSL/TLS support: Custom CA certificate configuration
  • Session management: Automatic UUID generation for HTTP mode
  • Dynamic API discovery: Based on official Kibana OpenAPI specification

Saved Objects Management

  • Complete CRUD operations for all Kibana saved object types
  • Intelligent search with pagination support
  • Bulk operations for efficient mass updates
  • Version control with optimistic concurrency
  • Reference management for object relationships

🔧 Configuration

Required Variables

VariableDescriptionExample
KIBANA_URLKibana server addresshttp://localhost:5601

Authentication (choose one method)

VariableDescriptionPriority
KIBANA_API_KEYAPI Key (base64 encoded)1st
KIBANA_USERNAME + KIBANA_PASSWORDBasic authentication2nd
KIBANA_COOKIESSession cookies3rd

Optional Variables

VariableDescriptionDefault
KIBANA_DEFAULT_SPACEDefault Kibana spacedefault
KIBANA_CA_CERTCA certificate path-
KIBANA_TIMEOUTRequest timeout (ms)60000
MCP_TRANSPORTTransport modestdio
MCP_HTTP_PORTHTTP server port3000
MCP_HTTP_HOSTHTTP server hostlocalhost
NODE_TLS_REJECT_UNAUTHORIZEDDisable SSL validation1

🛠️ Available Tools

Base Tools

  • get_status - Get Kibana server status
  • execute_kb_api - Execute custom Kibana API requests
  • search_elasticsearch - Search Elasticsearch documents and logs through Kibana without using the Dev Tools Console proxy
  • get_available_spaces - List available Kibana spaces
  • search_kibana_api_paths - Search API endpoints
  • list_all_kibana_api_paths - List all API endpoints
  • get_kibana_api_detail - Get API endpoint details

Saved Objects Tools

  • vl_search_saved_objects - Search saved objects (universal)
  • vl_get_saved_object - Get single saved object
  • vl_create_saved_object - Create new saved object
  • vl_update_saved_object - Update single saved object
  • vl_bulk_update_saved_objects - Bulk update operations
  • vl_bulk_delete_saved_objects - Bulk delete operations

Supported Object Types: dashboard, visualization, index-pattern, search, config, lens, map, tag, canvas-workpad, canvas-element

Analysis Tools (v0.6.0+)

  • analyze_object_dependencies - Analyze saved object dependencies
  • analyze_deletion_impact - Check impact before deletion
  • check_dashboard_health - Dashboard health check
  • scan_all_dashboards_health - Batch health scanning

Elasticsearch Data Search

Use search_elasticsearch when you need to search documents, application logs, traces, or aggregations in Elasticsearch. It sends Query DSL through Kibana's /internal/search/es route instead of the Dev Tools Console proxy.

This is useful when a Kibana user can read the target indices but does not have the Dev Tools Kibana privilege. In that case /api/console/proxy can return 403 even though normal Elasticsearch searches are allowed.

Example tool arguments for a bounded log search:

{
  "index": "application-logs-*",
  "body": {
    "size": 20,
    "_source": [
      "@timestamp",
      "message",
      "trace.id",
      "service.name"
    ],
    "sort": [
      { "@timestamp": "desc" }
    ],
    "query": {
      "bool": {
        "filter": [
          {
            "range": {
              "@timestamp": {
                "gte": "2025-01-15T10:00:00Z",
                "lt": "2025-01-15T11:00:00Z"
              }
            }
          },
          {
            "term": {
              "service.name.keyword": "example-service"
            }
          }
        ]
      }
    }
  }
}

For high-volume logs, start with a small time window and a small size. After finding a trace or correlation id, use that value in a second narrow search instead of repeatedly scanning a broad time range. Use _source to keep only fields needed for the current investigation.

The tool rejects wildcard-only index segments such as *, **, or _all (including inside comma-separated index expressions), an empty search body, and body.size above 100. String size values are coerced and validated as numbers. The endpoint is an internal Kibana API, so compatibility should be verified after major Kibana upgrades.

📖 Resources

Resource URIDescription
kibana-api://pathsList all available API endpoints
kibana-api://paths?search=<keyword>Search endpoints by keyword
kibana-api://path/{method}/{encoded_path}Get specific endpoint details

💬 Example Queries

Basic Operations

  • "What is the status of my Kibana server?"
  • "List all available Kibana spaces"
  • "Show me all API endpoints related to dashboards"

Elasticsearch & Logs

  • "Search the production logs for errors from service X in the last hour"
  • "Find this trace id and show the surrounding log events in chronological order"
  • "Search index application-logs-* using this Elasticsearch Query DSL"
  • "Aggregate error counts by service for this time range"

Saved Objects

  • "Search for all dashboards"
  • "Find visualizations containing 'nginx' in the title"
  • "Create a new dashboard named 'Sales Overview'"
  • "Update the description of dashboard 'my-dashboard-123'"
  • "Delete multiple dashboards by their IDs"

Health & Analysis

  • "Check health of dashboard 'overview'"
  • "Analyze dependencies for visualization 'viz-123'"
  • "Scan all dashboards for health issues"

🐛 Troubleshooting

Connection Issues

  • Verify Kibana URL is accessible
  • Check authentication credentials
  • For SSL issues: NODE_TLS_REJECT_UNAUTHORIZED=0 (use with caution)

Claude Desktop Issues

  • Restart Claude Desktop after config changes
  • Validate JSON config syntax
  • Check console logs for errors

Common Errors

  • "import: command not found": Update to latest version
  • Authentication failed: Verify credentials and permissions
  • SSL errors: Check CA certificate or disable SSL validation
  • 403 from /api/console/proxy while searching Elasticsearch: Use search_elasticsearch. The Console proxy can require the Kibana Dev Tools privilege even when the user has permission to read the target indices.

🔍 Debugging

Use MCP Inspector for debugging:

npm run inspector

This provides a browser-accessible debugging interface.

📦 Package Information

🤝 Contributing

This project is community-maintained. Contributions and feedback are welcome!

Please follow the Elastic Community Code of Conduct in all communications.

📄 License

Apache License 2.0 - See LICENSE file for details.