MCP Directory

How to add Meilisearch MCP Server to Cursor

Manage and search Meilisearch from any MCP client: indices, documents, settings, keys, and multi-index search. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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 Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
  2. 2Paste the Meilisearch MCP Server config below into the "mcpServers" object.
  3. 3Fill in placeholder secrets, then save.
  4. 4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
  5. 5Ask Cursor to use one of Meilisearch MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Meilisearch MCP Server config there under the "mcpServers" key and restart the client.

Is Meilisearch MCP Server safe to use with Cursor?

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