API Specification

This project is based on the official Elastic Kibana API documentation and uses the OpenAPI YAML specification from Elastic Stack 8.x (ES8) to dynamically retrieve and manage all Kibana API endpoints. For the latest details, see the Kibana API documentation.

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 community-maintained and is not an official product of Elastic or MCP.

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

# Or local installation
npm install @tocharian/mcp-server-kibana

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

# Set your Kibana credentials and run
KIBANA_URL=http://your-kibana-server:5601 \
KIBANA_USERNAME=your-username \
KIBANA_PASSWORD=your-password \
npx @tocharian/mcp-server-kibana

Add to your Claude Desktop configuration file:

Config file locations:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kibana-mcp-server": {
      "command": "npx",
      "args": ["@tocharian/mcp-server-kibana"],
      "env": {
        "KIBANA_URL": "http://your-kibana-server:5601",
        "KIBANA_USERNAME": "your-username",
        "KIBANA_PASSWORD": "your-password",
        "KIBANA_DEFAULT_SPACE": "default",
        "NODE_TLS_REJECT_UNAUTHORIZED": "0"
      }
    }
  }
}

# Create .env file
cat > kibana-mcp.env << EOF
KIBANA_URL=http://your-kibana-server:5601
KIBANA_USERNAME=your-username
KIBANA_PASSWORD=your-password
NODE_TLS_REJECT_UNAUTHORIZED=0
EOF

# Run with environment file
env $(cat kibana-mcp.env | xargs) npx @tocharian/mcp-server-kibana

• Connect to local or remote Kibana instances
• Secure authentication (username/password)
• SSL/TLS and custom CA certificate support
• Multi-space support for enterprise Kibana environments
• Exposes Kibana API endpoints as both tools and resources
• Search, view, and execute Kibana APIs from MCP clients
• Type-safe, extensible, and easy to integrate

├── index.ts                # Server entry point
├── src/
│   ├── types.ts            # Type definitions and schemas
│   ├── base-tools.ts       # Tool registration and API logic
│   ├── prompts.ts          # Prompt registration (expert & resource helper)
│   └── resources.ts        # Resource registration (API paths/URIs)
├── kibana-openapi-source.yaml # Kibana API OpenAPI index
├── README.md               # English documentation
├── README_zh.md            # Chinese documentation

Examples:

• kibana-api://paths?search=saved_objects
• kibana-api://path/GET/%2Fapi%2Fstatus

Configure the server via environment variables:

• NPM Package: @tocharian/mcp-server-kibana
• GitHub Repository: TocharinOU/mcp-server-kibana
• Node.js: >= 18.0.0
• Package Size: ~685KB (6.4MB unpacked)

# Make sure you're using the latest version
npm install -g @tocharian/mcp-server-kibana@latest

# Or try using node directly
node $(which mcp-server-kibana)

• Verify Kibana URL is accessible
• Check authentication credentials
• For SSL issues, try setting NODE_TLS_REJECT_UNAUTHORIZED=0

• Restart Claude Desktop after config changes
• Check config file syntax with a JSON validator
• Verify environment variables are set correctly

• "What is the status of my Kibana server?"
• "What is the status of my Kibana server in the 'marketing' space?"
• "List all available Kibana spaces I can access."
• "List all available Kibana API endpoints."
• "Show details for the POST /api/saved_objects/_find endpoint."
• "Execute a custom API request for /api/status."
• "Get a list of all dashboards in Kibana."
• "Get a list of all dashboards in the 'production' space."
• "Query API endpoints related to endpoint events."
• "List all case-related API endpoints."
• "Create a new case in Kibana."
• "Create a new dashboard in Kibana."
• "Create a new dashboard in the 'dev-team' space."

When using this server with Claude Desktop, two different prompt interaction modes are supported:

• How it works: Claude Desktop can directly call server tools (such as get_status, execute_api, search_kibana_api_paths, etc.) to answer your questions or perform actions.
• Best for: Users who want a conversational, guided experience. The server will automatically search, execute, and explain Kibana APIs.
• Example: "Show all Kibana API endpoints related to saved objects."
• Testing tip: Select the kibana-tool-expert prompt in Claude Desktop for integration testing, then start using it.

• How it works: Claude Desktop interacts with the server via resource URIs (such as kibana-api://paths or kibana-api://path/GET/%2Fapi%2Fstatus), and the server returns structured data for Claude to parse.
• Best for: Advanced users, MCP clients that only support resource access, or programming scenarios needing raw API metadata.
• Example: "Get resource kibana-api://paths?search=dashboard"

Note: The two endpoints in resources (kibana-api://paths and kibana-api://path/{method}/{encoded_path}) have corresponding base tools (list_all_kibana_api_paths, get_kibana_api_detail). This design ensures compatibility with MCP clients that cannot intelligently select multiple resources, making it easier for tools like Claude Desktop to interact with Kibana.

Tip: Most users are recommended to use tool mode for a more natural and powerful experience; resource mode offers maximum flexibility for advanced and compatibility use cases.

Install dependencies:

npm install

Build the server:

npm run build

Auto-rebuild in development mode:

npm run watch

Since the MCP server communicates via stdio, debugging can be inconvenient. It is recommended to use MCP Inspector:

npm run inspector

After starting, Inspector will provide a browser-accessible debugging tool URL.

This project is community-maintained. Contributions and feedback are welcome! Please be respectful and inclusive in all communications, and follow the Elastic Community Code of Conduct.

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

• Check if MCP configuration is correct
• Ensure the Kibana address is accessible
• Verify authentication credentials have sufficient permissions
• If using a custom CA, ensure the certificate path is correct and readable
• If using NODE_TLS_REJECT_UNAUTHORIZED=0, be aware of security risks
• Check error messages output in the terminal