home / mcp / meilisearch mcp server

Meilisearch MCP Server

A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "meilisearch-meilisearch-mcp": {
      "command": "uvx",
      "args": [
        "-n",
        "meilisearch-mcp"
      ],
      "env": {
        "MEILI_HTTP_ADDR": "http://localhost:7700",
        "MEILI_MASTER_KEY": "YOUR_MASTER_KEY"
      }
    }
  }
}

The Meilisearch MCP Server lets any MCP-compatible client interact with a Meilisearch instance through a conversational model. You can create indices, add documents, perform searches, adjust settings, and monitor tasks while switching between Meilisearch instances as needed. This setup enables natural language control over your search backend with flexible, zero-learning-curve integration.

How to use

You connect your MCP client (such as Claude Desktop or other MCP-enabled agents) to a running Meilisearch MCP Server. With this integration you can create indices, add or update documents, run searches across one or more indices, and tune settings all from conversational prompts. You can switch between different Meilisearch instances on the fly and keep an eye on health, tasks, and metrics from within your MCP client.

How to install

Prerequisites: you need a working Meilisearch instance and an MCP-compatible client. You will also use a runtime command to start the MCP server.

Step by step install and run flow:

1) Install the MCP server package using your preferred method.

2) Start the MCP server via your configured runtime command. The following example uses the standard runtime to launch the server locally with the Meilisearch MCP package.

Configuration and usage notes

Environment variables configure the default connection to Meilisearch and security keys. You can override these values in your MCP client as needed.

- MEILI_HTTP_ADDR specifies the Meilisearch URL. Example: http://localhost:7700.

- MEILI_MASTER_KEY sets the Meilisearch API key. Example: your_master_key.

Security and monitoring

Manage access with API keys and monitor health and tasks to ensure your Meilisearch instance runs smoothly. Use granular permissions for keys to control who can read, write, or manage indices and documents.

Keep an eye on health status and system metrics to quickly detect issues in indexing or search performance.

Examples of common actions

Create an index, add documents, and perform a search across indices through natural language prompts in your MCP client.

Tips for best results

Leverage multi-index search, filtering, and sorting to refine results. Use semantic or hybrid search when you need more relevant results across your indices.

Available tools

Connection Management

View and switch between Meilisearch connections, update API keys on the fly, and monitor current settings.

Index Operations

Create, list, delete indices, and view index statistics.

Document Operations

Add, update, and retrieve documents with pagination and bulk import.

Search

Perform searches with filters, sorting, facets, multi-index search, and semantic capabilities.

Settings Management

Configure ranking rules, facets, searchable attributes, and typo tolerance.

API Key Management

Create, view, update, and delete API keys with granular permissions.

Task Management

Monitor tasks, view progress, and cancel or clear tasks.

System Monitoring

Health checks, status, version, and statistics.