MCP Directory

How to add Meilisearch MCP Server to Windsurf

Manage and search Meilisearch from any MCP client: indices, documents, settings, keys, and multi-index search. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Meilisearch MCP Server config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Meilisearch MCP Server's tools become available to Cascade.

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 Windsurf

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

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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