What are the prerequisites for using the Elasticsearch MCP Server?

You need Node.js (v22+), an Elasticsearch instance, an Elasticsearch API key with appropriate permissions, and an MCP Client such as the Claude Desktop App.

What is Elasticsearch MCP Server?

It's a server that connects Elasticsearch data to any Model Context Protocol (MCP) Client, like Claude Desktop, allowing you to interact with your data using natural language.

What credentials does it need?

It reads `ES_URL`, `ES_API_KEY` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Elasticsearch MCP Server

Connects Elasticsearch data to any Model Context Protocol (MCP) Client, enabling natural language interaction.

Local serverstdio★ 702

What is the Elasticsearch MCP Server?

Connects Elasticsearch data to any Model Context Protocol (MCP) Client, enabling natural language interaction.

What the server does

The Elasticsearch MCP Server connects your AI agents to Elasticsearch data using the Model Context Protocol (MCP). It enables natural language interactions with your Elasticsearch indices, allowing agents to query, analyze, and retrieve data without custom APIs.

Credentials and setup notes

Before you start, ensure you have: - An Elasticsearch cluster (version 8.x or 9.x) accessible from your AWS environment - Elasticsearch authentication credentials: - An API key, or - A username and password pair - Docker installed and running in your AWS environment (for example, on an

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_indices	List all available Elasticsearch indices
get_mappings	Get field mappings for a specific Elasticsearch index
search	Perform an Elasticsearch search using query DSL
esql	Execute an ES\|QL query
get_shards	Get shard information for all or specific indices

How to install the Elasticsearch MCP Server

{
  "mcpServers": {
    "elasticsearch-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ES_URL",
        "-e",
        "ES_API_KEY",
        "docker.elastic.co/mcp/elasticsearch",
        "stdio"
      ],
      "env": {
        "ES_URL": "<elasticsearch-cluster-url>",
        "ES_API_KEY": "YOUR_ES_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
ES_URL	Declared in the maintainer’s client configuration.	Check documentation
ES_API_KEY	Declared in the maintainer’s client configuration.	Check documentation

Example prompts to try

“Use Elasticsearch to list indices.”
“Use Elasticsearch to get mappings.”
“Use Elasticsearch to search.”

Frequently asked questions

Key features include listing available Elasticsearch indices, inspecting field mappings, executing queries using full Query DSL with highlighting, and seamless integration with MCP Clients.