Skip to content
GitHub (opens in a new tab)

Databases · Integration guide

How to connect Meilisearch to any AI IDE (Claude/Codex/Cursor/VS Code/Antigravity)

Before you start, install GateRook and connect it to your AI development environment: Claude Desktop, Codex, Cursor, Antigravity or VS Code.

Connect your AI app

Indexes and documents of Meilisearch and Meilisearch Cloud: full-text search with filters, facets and sorting. Document writes and deletes wait for approval.

The screenshots show GateRook 2.0.0: the Meilisearch form, the endpoint selector, and this connector’s actual tool preview. The form and preview have not been saved. Select a screenshot to open it at full size.

1. Create a connection and enter the settings

In GateRook, open Connections, select Add connection, search for Meilisearch, choose its card and select Continue to configure.

Obtain the Meilisearch server URL and an API key restricted to the indexes and read operations the AI needs.

A search key can run searches; other read tools may require additional actions. Avoid using the server’s master key for routine AI queries.

Enter a Name, for example meilisearch-demo. Your AI app uses this name to choose the connection.

Enter Server URL, including its port for a self-managed deployment, and restrict Indexes to the intended index UIDs or patterns.

Select API key under Authentication and enter it. Choose No authentication only for a development server that deliberately checks no key.

If the server uses a private CA, enter CA certificate (PEM) under Advanced.

Choose Development, Staging or Production to match the service. Review the connector’s limit and access settings before continuing.

GateRook 2.0.0 Configure Meilisearch form before saving.
The Meilisearch configuration form. Enter your own connection settings before testing.

2. Test the connection and add it to an endpoint

Select Continue to test. GateRook checks the settings from your computer. Review the result and resolve any connection, certificate or permission error before continuing.

Check the key’s actions and index restrictions if some tools are denied. An index’s display name may differ from its UID; use the UID in requests.

After the test passes, select Continue to add to an endpoint. Choose the endpoint your AI app uses, review its tool modes, then select Save connection. GateRook offers default as the starter endpoint.

GateRook endpoint selector with default selected; no connector tool list is shown.
Choose the endpoint your AI app uses. This selector is shared across connector types; the next screenshot shows this connector’s own tools.

3. Use the connection from your AI IDE

After saving Meilisearch on the endpoint and passing its connection test, ask your AI app to use meilisearch-demo, or the name you chose. If its tools are missing, confirm the endpoint assignment and refresh the MCP connection or start a new chat.

The preview below shows this connector’s default tools before saving. The table explains what each tool can do; connection settings, credentials and endpoint policies can restrict access further.

Meilisearch connector tool names and default modes in the GateRook 2.0.0 endpoint preview.
Meilisearch tools in the Development endpoint preview. This is an unsaved preview, not a successful service call.

Start with a small read request. Replace example resource names with existing resources your connection may access. Open Activity after the call to inspect its connection, tool, arguments, policy decision and result metadata.

Ask your AI, for example

  • “Search products on meilisearch-demo for wireless headphones and return five results.”
  • “Describe the products index on meilisearch-demo if the key permits it.”
  • “Using meilisearch-demo, fetch product-123 from the products index.”
Tools your AI gets
ToolWhat it doesStarts as
search_list_indexesList the permitted Meilisearch indexes and available document counts.Read only
search_describe_indexShow the primary key, readable searchable/filterable/sortable attributes, ranking rules, configured embedders and index statistics.Read only
search_querySearch with text, filters, facets, sorting and pagination. Vector or hybrid search requires a configured embedder; choose it when the index has more than one.Read only
search_get_documentsDocuments by id, up to 100.Read only
search_index_documentsAdds or replaces up to 100 documents of one index, or merges their fields into existing ones. You approve the exact documents. Never retried.Approval
search_delete_documentsDeletes documents by id, up to 1,000 of one index. You approve the exact ids; nothing else is deleted. Never retried.Approval

You can change each tool’s mode on the endpoint. Every call your AI makes appears in Activity.

Service documentation

Keep exploring

Meilisearch Cloud

Connect Meilisearch Cloud to Claude, Codex, Cursor, VS Code or Antigravity with GateRook. Follow setup, connection testing and tool access with screenshots.

PostgreSQL

Connect PostgreSQL to Claude, Codex, Cursor, VS Code or Antigravity in three steps. Your AI runs read queries; changes wait for your approval.

MySQL

Connect MySQL to Claude, Codex, Cursor, VS Code or Antigravity in three steps. GateRook keeps the password; your AI reads data and asks before changes.

Browse all integration guides

Your local MCP gateway and firewall.

Connect Meilisearch to your AI IDE.

Choose a connector. Start with read-only access. Approve changes and inspect the audit trail.

Read the getting started guide

Get GateRook

Download GateRook 2.0.0 for your Mac, or get the Windows app from Microsoft Store.

macOS

Version 2.0.0 for Apple Silicon (arm64). This download does not support Intel Macs.

Open the DMG and drag GateRook to Applications.

Windows

Available for free from Microsoft Store. Install GateRook and receive updates through the Store.

macOS release notes and checksums (opens in a new tab)