Meilisearch
Enables AI assistants to interact with Meilisearch through a standardized interface, supporting index and document management, search capabilities, settings configuration, task monitoring, and experimental vector search.
What is Meilisearch?
Meilisearch is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to interact with meilisearch through a standardized interface, supporting index and document management, search capabilities, settings configuration, task monitoring, and experim...
Enables AI assistants to interact with Meilisearch through a standardized interface, supporting index and document management, search capabilities, settings configuration, task monitoring, and experimental vector search.
This server falls under the Search & Data Extraction category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to interact with Meilisearch through a
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx meilisearch-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Meilisearch
The Meilisearch MCP Server gives AI assistants a standardized interface to a running Meilisearch instance, supporting full index and document management, keyword and semantic search, settings configuration, API key management, and task monitoring. It lets AI agents create indexes, ingest documents, run filtered searches, and tune ranking rules without any custom integration code. Developers building RAG pipelines, search-enabled chatbots, or AI-assisted content management systems use it to drive Meilisearch operations directly from their AI client.
Prerequisites
- Python 3.9 or later
- A running Meilisearch instance (local via Docker or hosted on Meilisearch Cloud)
- Meilisearch master key if the instance has API key protection enabled
- An MCP-compatible client such as Claude Desktop or an OpenAI agents framework
- uvx (recommended) or pip for installing the meilisearch-mcp package
Start a Meilisearch instance
If you don't already have Meilisearch running, start a local instance using Docker. The default port is 7700.
docker run -it --rm -p 7700:7700 getmeili/meilisearch:latestInstall the meilisearch-mcp package
Install via pip or uvx. The uvx method is recommended as it runs the package in an isolated environment without polluting your global Python installation.
# Recommended
pip install meilisearch-mcp
# Or with uvx (no install needed at runtime)
uvx -n meilisearch-mcpSet environment variables for your Meilisearch instance
Configure the server URL and optional master key via environment variables. These can be set in your shell or directly in the MCP client config.
export MEILI_HTTP_ADDR=http://localhost:7700
export MEILI_MASTER_KEY=your-master-key-hereAdd the server to your MCP client configuration
Add meilisearch-mcp to your claude_desktop_config.json or equivalent MCP config file, passing the environment variables inline.
{
"mcpServers": {
"meilisearch": {
"command": "uvx",
"args": ["-n", "meilisearch-mcp"],
"env": {
"MEILI_HTTP_ADDR": "http://localhost:7700",
"MEILI_MASTER_KEY": "your-master-key-here"
}
}
}
}Verify the connection and start using search tools
Restart your MCP client and ask the AI to check the Meilisearch health status. You can then create indexes, add documents, and run searches through natural language prompts.
Meilisearch Examples
Client configuration (Claude Desktop)
Full configuration block for claude_desktop_config.json using uvx to run meilisearch-mcp with connection details passed as env vars.
{
"mcpServers": {
"meilisearch": {
"command": "uvx",
"args": ["-n", "meilisearch-mcp"],
"env": {
"MEILI_HTTP_ADDR": "http://localhost:7700",
"MEILI_MASTER_KEY": "your-master-key-here"
}
}
}
}Prompts to try
Example queries once the Meilisearch MCP server is connected.
- "Create a new index called 'products' with 'id' as the primary key"
- "Add these 5 product documents to the products index"
- "Search for 'wireless headphones' in the products index with a price filter under $100"
- "Show me the current search settings for the products index"
- "Check the health status of my Meilisearch instance"
- "Create an API key with search-only permissions for the products index"Troubleshooting Meilisearch
Connection refused or timeout when connecting to Meilisearch
Verify Meilisearch is running and accessible at the URL in MEILI_HTTP_ADDR. Test with curl http://localhost:7700/health. If using Docker, ensure the container port is mapped with -p 7700:7700.
Authentication error — invalid API key
Set MEILI_MASTER_KEY to match the master key your Meilisearch instance was started with. If you started Meilisearch without a master key, leave MEILI_MASTER_KEY unset. Check the Meilisearch logs for the exact key it expects.
uvx command not found when starting the MCP server
Install uv by running pip install uv or follow the uv installation docs at https://docs.astral.sh/uv/. Alternatively, use pip install meilisearch-mcp and change the command to meilisearch-mcp in your config.
Frequently Asked Questions about Meilisearch
What is Meilisearch?
Meilisearch is a Model Context Protocol (MCP) server that enables ai assistants to interact with meilisearch through a standardized interface, supporting index and document management, search capabilities, settings configuration, task monitoring, and experimental vector search. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Meilisearch?
Follow the installation instructions on the Meilisearch GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Meilisearch?
Meilisearch works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Meilisearch free to use?
Yes, Meilisearch is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Meilisearch Alternatives — Similar Search & Data Extraction Servers
Looking for alternatives to Meilisearch? Here are other popular search & data extraction servers you can use with Claude, Cursor, and VS Code.
TrendRadar
★ 58.0kA real-time hotspot monitoring and news aggregation assistant that provides AI-powered analysis of trending topics across multiple platforms via the Model Context Protocol. It enables users to track news and receive automated notifications through va
Scrapling
★ 52.7k🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!
PDF Math Translate
★ 33.9k[EMNLP 2025 Demo] PDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译，支持 Google/DeepL/Ollama/OpenAI 等服务，提供 CLI/GUI/MCP/Docker/Zotero
GPT Researcher
★ 27.2kAn autonomous agent that conducts deep research on any data using any LLM providers
Agent Reach
★ 20.1kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Xiaohongshu
★ 13.7kMCP for xiaohongshu.com
Browse More Search & Data Extraction MCP Servers
Explore all search & data extraction servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Meilisearch in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Meilisearch?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.