Elasticsearch MCP Server
by tocharianouio.github.TocharianOU/elasticsearchv0.7.2
Elasticsearch MCP Server with multi-version support (ES 5.x-9.x) and comprehensive API access
context tax
queued
security
queued
cold start
queued
freshness
Maintained42d ago
Install Elasticsearch MCP server
Install in Claude Code
claude mcp add elasticsearch -e ES_URL='<es-url>' -e ES_API_KEY='<es-api-key>' -e ES_PASSWORD='<es-password>' -- npx -y @tocharianou/elasticsearch-mcpInstall in Cursor
{
"mcpServers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<es-url>",
"ES_API_KEY": "<es-api-key>",
"ES_PASSWORD": "<es-password>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<es-url>",
"ES_API_KEY": "<es-api-key>",
"ES_PASSWORD": "<es-password>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"elasticsearch": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<es-url>",
"ES_API_KEY": "<es-api-key>",
"ES_PASSWORD": "<es-password>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@tocharianou/elasticsearch-mcp"
],
"env": {
"ES_URL": "<es-url>",
"ES_API_KEY": "<es-api-key>",
"ES_PASSWORD": "<es-password>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ES_URL | yes | — | Your Elasticsearch instance URL (e.g., https://localhost:9200) |
| ES_API_KEY | — | yes | Elasticsearch API key for authentication |
| ES_USERNAME | — | — | Elasticsearch username for basic authentication |
| ES_PASSWORD | — | yes | Elasticsearch password for basic authentication |
| ES_CA_CERT | — | — | Path to custom CA certificate for Elasticsearch SSL/TLS |
| NODE_TLS_REJECT_UNAUTHORIZED | — | — | Set to '0' to disable SSL certificate validation (development only) |
| MAX_TOKEN_CALL | — | — | Maximum tokens per API call |
| MCP_TRANSPORT | yes | — | Transport mode selection |
| MCP_HTTP_PORT | — | — | HTTP server port (when using HTTP transport) |
| MCP_HTTP_HOST | — | — | HTTP server host (when using HTTP transport) |
Freshness
Maintained — last maintenance signal 42d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-28 · 42d ago · GitHub
Latest release
2026-08-25 · 45d ago · GitHub · v0.9.0
Package published
no data · npm/PyPI
Registry entry updated
2026-02-02 · 8mo ago · official registry · v0.7.2
FAQ
›How do I install the Elasticsearch MCP server in Claude Code?
Run: claude mcp add elasticsearch -e ES_URL='<es-url>' -e ES_API_KEY='<es-api-key>' -e ES_PASSWORD='<es-password>' -- npx -y @tocharianou/elasticsearch-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Elasticsearch require an API key?
Yes. It expects ES_URL, MCP_TRANSPORT, ES_API_KEY, ES_PASSWORD, of which 2 are secrets.
›Can I use Elasticsearch as a remote (hosted) MCP server?
Yes — it offers both a hosted endpoint and a local stdio package.
›Is Elasticsearch in the official MCP registry?
Yes, as io.github.TocharianOU/elasticsearch.