List IndicesLABSCO SUMMARY
The cluster answers questions and accepts changes on the same connection.
Read-only Elasticsearch servers stop at search. This one carries the writes too — bulk operations, update by query, index management — which is what turns 'find the bad documents' into 'and fix them'.
What it is
A TypeScript MCP server over Elasticsearch. It carries full CRUD for documents and indices, bulk operations in a single API call, updates and deletes driven by a query, and the cluster reads — health, shards and templates.
What you get
- Elasticsearch DSL queries with highlighting, against any index
- Documents created, read, updated and deleted
- Indices created and managed
- Many operations sent in one bulk API call
- Documents updated or removed by query rather than one id at a time
- Cluster health, shard state and index templates read
Requirements
An Elasticsearch cluster reachable at ES_URL, with ES_API_KEY and ES_VERSION. Install with npm install -g @octodet/elasticsearch-mcp, or run it through npx.
Setup effort
One command plus a key — npm install -g @octodet/elasticsearch-mcp, then supply credentials
USE CASES
01
Finding out what is in an index
Run a DSL query with highlighting rather than rebuilding it in a dashboard.
02
Fixing a field across many documents
Update by query instead of one document at a time.
03
Loading a batch of records
Send the operations in a single bulk call.
04
Checking a cluster that is behaving oddly
Read health, shards and templates before changing anything.
16 tools
Listed in project docs. Your client may show a different list.
Get MappingsSearchGet Cluster HealthGet ShardsAdd DocumentUpdate DocumentDelete DocumentUpdate By QueryDelete By QueryBulk OperationsCreate IndexDelete IndexCount DocumentsGet TemplatesGet AliasesBEFORE YOU INSTALL
What to know first
Tools you get
16 tools named in the project's documentation.
Requires
- npx on PATH
- ES_API_KEY in your environment
- ES_URL in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @octodet/elasticsearch-mcpMCP Clients
VS Code
VS CODE · JSON
{
"servers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@octodet/elasticsearch-mcp"
],
"env": {
"ES_URL": "http://localhost:9200",
"ES_API_KEY": "<YOUR_ES_API_KEY>",
"ES_VERSION": "8"
}
}
}
}Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"elasticsearch": {
"command": "npx",
"args": [
"-y",
"@octodet/elasticsearch-mcp"
],
"env": {
"ES_URL": "http://localhost:9200",
"ES_API_KEY": "<YOUR_ES_API_KEY>",
"ES_VERSION": "8"
}
}
}
}
