-
Download the latest version of the Algolia MCP server at https://github.com/algolia/mcp-node/releases
-
Extract the Zip file
-
From a terminal, run
xattr -r -d com.apple.quarantine <path_to_executable>
Important
Why do you need to run this command?
This executable is not signed because I don't have a payed Apple Developer Account.
This means that macOS will "quarantine" it by default when it is downloaded from the internet.
The command remove the quarantine, allowing you to run the program. If you don't trust the build,
you can always build it yourself from source with npm run build (see development environment setup below) 😄.
- Configure Claude Desktop
{
"mcpServers": {
"algolia-mcp": {
"command": "<path_to_executable>"
}
}
}- Restart Claude Desktop
Algolia Node MCP lets you interact with your Algolia apps and indices. Here are some example prompts to get you started:
- "What is the email address associated to my account?"
- "List all my apps Algolia apps."
- "List all the apps that I own."
- "What's the ID for app Latency?"
- "Search all items in the products index of app Latency where brand = 'Nike' and price < 100."
- "Retrieve the top 10 best tech books and save them in the books index of app Latency with their ISBN at the objectID."
- "Do I have any AB Tests currently running on application <APPLICATION_ID>?"
- "I have an index named <index_name> on application <application_id>, can you generate a graph for no results rate in DE region over the past month? Please use react and recharts."
- "Are there any incidents going on at Algolia currently?"
Usage: algolia-mcp [options] [command]
Options:
-h, --help display help for command
Commands:
start-server [options] Starts the Algolia MCP server
authenticate Authenticate with Algolia
logout Remove all stored credentials
list-tools List all available tools
help [command] display help for commandUsage: algolia-mcp start-server [options]
Starts the Algolia MCP server
Options:
-o, --allow-tools <tools> Comma separated list of tool ids (default:
["listIndices","getSettings","searchSingleIndex","getTopSearches","getTopHits","getNoResultsRate"])
-h, --help display help for commandYou need at least Node 22
git clone https://github.com/algolia/mcp-node
cd mcp-node
npm iAnd then you'll need to configure Claude Desktop like so:
{
"mcpServers": {
"algolia-mcp": {
"command": "<PATH_TO_BIN>/node",
"args": [
"--experimental-strip-types",
"--no-warnings=ExperimentalWarning",
"<PATH_TO_PROJECT>/src/app.ts"
]
}
}
}Tip
You'll need to restart Claude Desktop every time you make a modification.
You can test and debug tools using the MCP Inspector.
Navigate to the respository and run the debug script:
cd path/to/mcp-node
npm run debugThen go to http://127.0.0.1:6274/ and click Connect to start the server.