MCP Directory

How to add Meilisearch MCP Server to Claude Desktop

Manage and search Meilisearch from any MCP client: indices, documents, settings, keys, and multi-index search. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 192★ · stdio · apikey · official

Claude Desktop config for Meilisearch MCP Server

pip install meilisearch-mcp
{
  "mcpServers": {
    "meilisearch-mcp-server": {
      "command": "uvx",
      "args": [
        "-n",
        "meilisearch-mcp"
      ],
      "env": {
        "MEILI_HTTP_ADDR": "http://localhost:7700",
        "MEILI_MASTER_KEY": "<your-master-key>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Meilisearch MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Meilisearch MCP Server's tools appear under the 🔌 tools menu.

Before you start

  • A running Meilisearch instance, e.g. docker run -d -p 7700:7700 getmeili/meilisearch:v1.28
  • Python >= 3.9 with pip, or uv/uvx (recommended)
  • Optional MEILI_MASTER_KEY if your instance requires authentication

What Meilisearch MCP Server can do in Claude Desktop

get-connection-settings

View current Meilisearch URL and API key status.

update-connection-settings

Switch to a different Meilisearch instance or key at runtime.

create-index

Create a new index with optional primary key.

list-indexes

List all available indexes.

delete-index

Delete an index and all its documents.

get-index-metrics

Detailed metrics for a specific index.

get-documents

Retrieve documents with pagination.

add-documents

Add or update documents in an index.

Security

With the master key configured, the agent can delete indices, rewrite settings, and mint API keys — use a scoped key instead of the master key where possible. The README itself warns that switching hosts/keys via chat tools is a development convenience and not production-grade practice.

Meilisearch MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Meilisearch MCP Server config there under the "mcpServers" key and restart the client.

Is Meilisearch MCP Server safe to use with Claude Desktop?

With the master key configured, the agent can delete indices, rewrite settings, and mint API keys — use a scoped key instead of the master key where possible. The README itself warns that switching hosts/keys via chat tools is a development convenience and not production-grade practice.

Is meilisearch-mcp free and official?

Yes on both: it is MIT-licensed and maintained in the meilisearch GitHub organization. You still need a Meilisearch instance — self-hosted is free, Meilisearch Cloud is paid.

Does it work with clients other than Claude?

Yes. It is a standard stdio MCP server and the README explicitly targets any MCP-compatible client, including OpenAI agents. There is also a Docker image (getmeili/meilisearch-mcp) for n8n-style containerized setups.

Can it do vector/semantic search?

Yes — the search tooling covers Meilisearch's semantic vector search and hybrid keyword+semantic mode, alongside classic filtered and faceted search. You configure embedders on the Meilisearch side and query through the same search tool.

View repo Full Meilisearch MCP Server page