How do I install the elasticsearch mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `ES_HOST`, `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

Local serverstdioGo

What is the Elasticsearch MCP Server?

Elasticsearch MCP lets Claude, Cursor and other MCP clients work with Elasticsearch MCP directly. Elasticsearch MCP Server.

What Elasticsearch MCP does

MCP Server for connecting to your Elasticsearch cluster directly from any MCP Client (like Claude Desktop, Cursor).

Requirements

An Elasticsearch instance * Elasticsearch authentication credentials (API key or username/password) * MCP Client (e.g. Claude Desktop, Cursor)

Practical notes

Maintained by awesimon, written in Go.

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
elasticsearch_health	Get Elasticsearch cluster health status, optionally including index-level details
list_indices	List available Elasticsearch indices, support regex
create_index	Create Elasticsearch index with optional settings and mappings
reindex	Reindex data from a source index to a target index with optional query and script
get_mappings	Get field mappings for a specific Elasticsearch index
create_mapping	Create or update mapping structure for an Elasticsearch index
search	Perform an Elasticsearch search with the provided query DSL
bulk	Bulk data into an Elasticsearch index
create_index_template	Create or update an index template
get_index_template	Get information about index templates
delete_index_template	Delete an index template

How to install the Elasticsearch MCP Server

{
  "mcpServers": {
    "elasticsearch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@awesome-ai/elasticsearch-mcp"
      ],
      "env": {
        "ES_HOST": "your-elasticsearch-host",
        "ES_API_KEY": "YOUR_ES_API_KEY"
      }
    }
  }
}

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

Configuration

An Elasticsearch instance * Elasticsearch authentication credentials (API key or username/password) * MCP Client (e.g. Claude Desktop, Cursor)

Variable	Description	Required
ES_HOST	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 MCP to elasticsearch health.”
“Use Elasticsearch MCP to list indices.”
“Use Elasticsearch MCP to create index.”

Frequently asked questions

Elasticsearch MCP Server Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.