Elasticsearch MCP Server
Provides read-only tools for Elasticsearch 7.10 clusters, including cluster info, cluster health, index listing, and full Query DSL search with pagination, sorting, and source filtering.
Supports Google OAuth with PKCE for interactive access, restricted to @maestra.io domain, enabling secure authentication for the MCP server.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Elasticsearch MCP Servercheck Elasticsearch cluster health"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Elasticsearch MCP Server
A read-only MCP (Model Context Protocol) server for Elasticsearch, providing secure access to ES 7.10 clusters via Streamable HTTP transport with Google OAuth + static Bearer token authentication.
Tools
es_cluster_info— cluster name, version, taglinees_cluster_health— cluster status, nodes, shardses_index_list— all indices with health, doc count, storage sizees_search— full Query DSL search with pagination, sorting, source filtering
Related MCP server: Elasticsearch MCP Server
Environment Variables
Variable | Required | Default | Description |
| yes | — | Comma-separated ES node URLs |
| yes | — | Comma-separated static Bearer tokens |
| no |
| HTTP listen port |
| no |
| Public URL for OAuth redirects |
| no | — | Enables Google OAuth when set |
| no | — | Required with GOOGLE_CLIENT_ID |
| no |
| ES request timeout (ms) |
| no |
| Max retries on 502/503/504/429 |
| no |
| Max concurrent MCP sessions |
Development
npm install
npm run build
npm run dev # tsx watch mode
npm test # vitestDocker
docker build -t mcp-elasticsearch .
docker run -e ES_ADDRESSES=http://es:9200 -e API_TOKENS=my-token -p 8080:8080 mcp-elasticsearchAuthentication
Static Bearer tokens — for programmatic access and Teleport
Google OAuth + PKCE — for interactive access via Claude Code (restricted to
@maestra.io)
Auth is handled entirely in the application; no Traefik middleware required.
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for AIStatusDashboard status, incidents, metrics, and fallback recommendations.
- IrisOAuthbio.irishealth
Read-only health context MCP server for Iris users.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Federated commerce search across independent WooCommerce merchants. Keyless, read-only MCP server.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables interaction with Elasticsearch and OpenSearch clusters for searching documents and managing indices. It provides tools for cluster health monitoring, index configuration, and general API requests.16Apache 2.0
- AlicenseNot gradedqualityDmaintenanceMCP server that provides tools and resources to interact with Elasticsearch clusters, including listing indices, searching, and retrieving mappings.3MIT
- AlicenseAqualityDmaintenanceRead-only MCP server for exploring and searching OpenSearch clusters, enabling log analysis, index exploration, and query execution.8MIT
- AlicenseBqualityBmaintenanceA read-only MCP server for investigating Amazon OpenSearch Service domains using natural language, with tools for cluster health, index management, search, and diagnostics, secured by allowed profiles and regions.20MIT