How to integrate Algolia MCP with Claude Code

Connect Claude Code to Algolia MCP. Export all records from products index, clear all objects from blog_posts index, and more using natural language, with authentication handled for you.

Algolia logoAlgolia
Api Key

Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.

127 Tools

Introduction

Manage your Algolia directly from Claude Code with zero worries about OAuth hassles, API-breaking issues, or reliability and security concerns.

You can do this in two different ways:

  1. Via Composio Connect - Direct and easiest approach
  2. Via Composio SDK - Programmatic approach with more control

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Algolia with

Why use Composio?

  • Only one MCP URL to connect multiple apps with Claude Code with zero auth hassles.
  • Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Handling Large tool responses out of LLM context to minimize context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need.

Connecting Algolia to Claude Code using Composio

1. Add the Composio MCP to Claude

Terminal

2. Start Claude Code

bash
claude

3. Open your MCP list

bash
/mcp

4. Select Composio and click on Authenticate

Select Composio and click Authenticate

5. This will redirect you to the Composio OAuth page. Complete the flow by authorizing Composio and you're all set.

Composio OAuth authorization page
Composio authorization complete
Ask Claude to connect to your account and authenticate via the link

What is the Algolia MCP server, and what's possible with it?

The Algolia MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Algolia account. It provides structured and secure access to your search indexes, records, ingestion resources, tests, and analytics events, so your agent can find records, update index content, configure ingestion, manage tests, and record user interactions on your behalf.

  • Index and record management: Have your agent browse indexes, find and retrieve records, add or replace content, delete matching records, copy indexes, or run batch operations across multiple indexes.
  • Search testing and configuration: Let the agent create, inspect, and delete A/B tests, manage query suggestion configurations, and create or update recommendation rules.
  • Ingestion setup: Direct your agent to create and manage data sources, destinations, transformations, and ingestion tasks that move content into Algolia.
  • Rules and synonyms cleanup: Instruct your agent to export search rules, remove selected rules or synonyms, or clear all rules and synonyms from an index.
  • Analytics event tracking: Have your agent record clicked items, clicks following searches, and conversion events for items outside a search context.

Connecting Algolia via Composio SDK

Composio SDK is the underlying technology that powers these integrations. It provides a universal gateway with full programmatic control. You can programmatically generate an MCP URL with the app you need (here Algolia) for even more tool search precision. It's secure and reliable.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step10 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Claude Pro, Max, or API billing enabled Anthropic account
  • Composio API Key
  • A Algolia account
  • Basic knowledge of Python or TypeScript
2

Install Claude Code

bash
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Windows CMD
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

To install Claude Code, use one of the following methods based on your operating system:

3

Set up Claude Code

bash
cd your-project-folder
claude

Open a terminal, go to your project folder, and start Claude Code:

  • Claude Code will open in your terminal
  • Follow the prompts to sign in with your Anthropic account
  • Complete the authentication flow
  • Once authenticated, you can start using Claude Code
Claude Code initial setup showing sign-in prompt
Claude Code terminal after successful login
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here

Create a .env file in your project root with the following variables:

  • COMPOSIO_API_KEY authenticates with Composio (get it from Composio dashboard)
  • USER_ID identifies the user for session management (use any unique identifier)
5

Install Composio library

npm install @composio/core dotenv

Install the Composio TypeScript library to create MCP sessions.

  • @composio/core provides the core Composio functionality
  • dotenv loads environment variables from your .env file
6

Generate Composio MCP URL

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['algolia'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http algolia-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Create a script to generate a Composio MCP URL for Algolia. This URL will be used to connect Claude Code to Algolia.

What's happening

  • We import the Composio client and load environment variables
  • Create a Composio instance with your API key
  • Call create() to create a Tool Router session for Algolia
  • The returned mcp.url is the MCP server URL that Claude Code will use
  • The script prints this URL so you can copy it
7

Run the script and copy the MCP URL

node --loader ts-node/esm generate_mcp_url.ts
# or if using tsx
tsx generate_mcp_url.ts

Run your TypeScript script to generate the MCP URL.

  • The script connects to Composio and creates a Tool Router session
  • It prints the MCP URL and the exact command you need to run
  • Copy the entire claude mcp add command from the output
8

Add Algolia MCP to Claude Code

bash
claude mcp add --transport http algolia-composio "YOUR_MCP_URL_HERE" --headers "X-API-Key:YOUR_COMPOSIO_API_KEY"

# Then restart Claude Code
exit
claude

In your terminal, add the MCP server using the command from the previous step. The command format is:

  • claude mcp add registers a new MCP server with Claude Code
  • --transport http specifies that this is an HTTP-based MCP server
  • The server name (algolia-composio) is how you'll reference it
  • The URL points to your Composio Tool Router session
  • --headers includes your Composio API key for authentication

After running the command, close the current Claude Code session and start a new one for the changes to take effect.

9

Verify the installation

bash
claude mcp list

Check that your Algolia MCP server is properly configured.

  • This command lists all MCP servers registered with Claude Code
  • You should see your algolia-composio entry in the list
  • This confirms that Claude Code can now access Algolia tools

If everything is wired up, you should see your algolia-composio entry listed:

Claude Code MCP list showing the toolkit MCP server
10

Authenticate Algolia

The first time you try to use Algolia tools, you'll be prompted to authenticate.

  • Claude Code will detect that you need to authenticate with Algolia
  • It will show you an authentication link
  • Open the link in your browser (or copy/paste it)
  • Complete the Algolia authorization flow
  • Return to the terminal and start using Algolia through Claude Code

Once authenticated, you can ask Claude Code to perform Algolia operations in natural language. For example:

  • "Export all records from products index"
  • "Clear all objects from blog_posts index"
  • "Copy index settings from staging to production"

Complete Code

Here's the complete code to get you started with Algolia and Claude Code:

import 'dotenv/config';
import { Composio } from '@composio/core';

const { COMPOSIO_API_KEY, USER_ID } = process.env;

if (!COMPOSIO_API_KEY || !USER_ID) {
  throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
}

const composioClient = new Composio({ apiKey: COMPOSIO_API_KEY });

const composioSession = await composioClient.create(USER_ID, {
  toolkits: ['algolia'],
});

const composioMcpUrl = composioSession?.mcp.url;

console.log(`MCP URL: ${composioMcpUrl}`);
console.log(`\nUse this command to add to Claude Code:`);
console.log(`claude mcp add --transport http algolia-composio "${composioMcpUrl}" --headers "X-API-Key:${COMPOSIO_API_KEY}"`);

Conclusion

You've successfully integrated Algolia with Claude Code using Composio's MCP server. Now you can interact with Algolia directly from your terminal using natural language commands.

Key features of this setup:

  • Terminal-native experience without switching contexts
  • Natural language commands for Algolia operations
  • Secure authentication through Composio's managed MCP
  • Tool Router for dynamic tool discovery and execution

Next steps:

  • Try asking Claude Code to perform various Algolia operations
  • Add more toolkits to your Tool Router session for multi-app workflows
  • Integrate this setup into your development workflow for increased productivity

You can extend this by adding more toolkits, implementing custom workflows, or building automation scripts that leverage Claude Code's capabilities.

TOOLS

Supported Tools

Every Algolia action and event your agent gets out of the box.

Add AB Test

Tool to create an A/B test comparing search performance between two index variants.

Add or Replace Record

Tool to add or replace a specific record in an index by objectID.

Add Record to Index

Tool to add a record to an index with auto-generated objectID.

Browse Algolia Index

Browse a batch of records in an Algolia index, optionally filtering them by query or browse parameters.

Clear Objects

Tool to clear records of an index without affecting settings.

Clear Rules

Clear all rules from an Algolia index, optionally forwarding the operation to replica indices.

Clear Synonyms

Clear all synonyms from an Algolia index, optionally forwarding the operation to replica indices.

Clicked Object IDs

Tool to send a click event to Algolia to capture clicked items.

Clicked Object IDs After Search

Tool to send a click event after a search response.

Converted Object IDs

Tool to send a conversion event for items outside of search context.

Copy Index

Initiate an index copy and return an asynchronous task ID.

Create API Key

Tool to create a new API key with specific permissions and restrictions.

Create Authentication

Create an authentication resource in the US region of Algolia's ingestion API for connecting to sources or destinations.

Create Destination

Create a destination for data ingestion using the US Algolia Ingestion API endpoint.

Create Ingestion Task

Create an ingestion task connecting a source to a destination for data synchronization with an Algolia index.

Create or Update Recommend Rules

Tool to create or update a batch of Recommend Rules in an index.

Create Query Suggestions Config

Tool to create a new Query Suggestions configuration for an Algolia index.

Create Source

Tool to create a new data source in Algolia Ingestion API.

Create Transformation

Tool to create a new transformation in Algolia Ingestion API.

Delete AB Test

Tool to delete an A/B test by its unique identifier.

Delete API Key

Delete an Algolia API key to revoke access.

Delete Authentication

Delete an Algolia ingestion authentication resource by ID in the US region.

Delete Query Suggestions Config

Tool to delete a Query Suggestions configuration for the specified index.

Delete Destination

Delete a destination by ID using the US Algolia Ingestion API endpoint.

Delete Index

Tool to delete the specified index and all its records.

Delete Multiple Records

Tool to delete multiple records from an Algolia index.

Delete Recommend Rule

Tool to delete a Recommend rule from a recommendation scenario.

Delete Records by Filter

Tool to delete records matching a filter from an Algolia index.

Delete Rule

Tool to delete the specified rule from an index.

Delete Source

Delete an Algolia Ingestion API source by ID.

Delete Synonym

Tool to delete a synonym from a specified index.

Delete Transformation

Tool to delete a transformation in Algolia Ingestion API.

Delete User Profile

Tool to delete a user profile from personalization.

Delete User Token

Delete events related to a user token from Algolia Insights event metrics and analytics using the US Insights endpoint.

Batch Operations on Multiple Indices

Tool to perform batch operations (add, update, delete) across multiple Algolia indices in a single request.

Export Rules

Export a page of rules from an Algolia index for backup or migration.

Find Object

Tool to find the first object matching a query or filter in an index.

Get A/B Test

Retrieve an A/B test by ID from the DE analytics region, including its status, performance metrics, and configuration details.

Get Add to Cart Rate

Tool to retrieve add-to-cart rate metrics for e-commerce search analytics.

Get API Key

Tool to retrieve the permissions and details of a specific API key.

Get App Task Status

Tool to check the status of an application task.

Get Authentication

Tool to retrieve an authentication resource by its ID.

Get Average Click Position

Tool to retrieve average click position metrics from Algolia Analytics.

Get Click Positions

Tool to retrieve the distribution of clicks by position from Algolia Analytics.

Get Click Through Rate

Tool to retrieve click-through rate (CTR) for searches with at least one click event.

Get Query Suggestions Config

Tool to retrieve a Query Suggestions configuration by index name.

Get Personalization Config

Retrieve the advanced personalization configuration from the EU endpoint, including personalization settings, re-ranking impact and profile type.

Get Conversion Rate

Retrieve conversion rate analytics for an index from the US analytics endpoint, including daily breakdowns.

Get Destination

Retrieve an Algolia ingestion destination by ID using the US endpoint.

Get Dictionary Languages

Tool to list available languages for dictionary entries.

Get Dictionary Settings

Tool to retrieve dictionary settings for all dictionaries.

Get Logs

Tool to retrieve log entries for API requests made to your Algolia application.

Get No Click Rate

Retrieve aggregate and daily no-click rates for tracked searches on an index, with optional date and tag filters.

Get No Results Rate

Retrieve aggregate and daily no-results rates for an index using the US analytics endpoint.

Get No Results Searches

Retrieve frequent searches that produced zero results for an index using the US analytics endpoint.

Get Object Position

Find an object’s zero-based position by objectID in the hits of a supplied search response.

Get multiple objects

Tool to retrieve multiple records from an index.

Get Purchase Rate

Retrieve purchase rate metrics for an index, including daily breakdowns, from the US analytics region.

Get Recommend Rule

Tool to retrieve a Recommend rule that was previously created in the Algolia dashboard.

Get Recommend Task Status

Tool to check the status of a Recommend task.

Get Record from Index

Tool to retrieve a specific record from an index by its objectID.

Get Revenue

Retrieve search-related revenue data from Algolia Analytics using the US regional endpoint.

Get Rule

Tool to retrieve a specific rule by its objectID from an index.

Get Searches Count

Retrieve search counts for an index over a time range, including a daily breakdown, using the US regional Analytics endpoint.

Get Searches No Clicks

Retrieve top searches without clicks from Algolia Analytics using the US regional endpoint, to help identify queries that may need optimization.

Get Index Settings

Retrieve selected settings for a specified Algolia index to inspect its configuration.

Get Source

Tool to retrieve a source from the Algolia Ingestion API.

Get Synonym

Tool to retrieve a specific synonym by its objectID.

Get Task Status

Tool to check the status of an asynchronous task.

Get Top Countries

Retrieve top countries by search volume for a specified index using the US analytics endpoint, to analyze the geographic distribution of searches.

Get Top Filter Attributes

Tool to retrieve top filter attributes from Algolia Analytics.

Get Top Filter For Attribute

Tool to retrieve top filter values for a specific attribute from Algolia Analytics.

Get Top Filters No Results

Tool to retrieve top filters for searches that returned no results from Algolia Analytics.

Get Top Hits

Tool to retrieve the object IDs of the most frequent search results from Algolia Analytics.

Get Top Searches

Retrieve popular search queries from Algolia Analytics, with optional click analytics and revenue metrics.

Get Transformation

Tool to retrieve a transformation by its ID from Algolia's Ingestion API.

Get Usage Statistics

Tool to retrieve Algolia usage statistics over a specified time period.

Get Usage for Index

Retrieve usage statistics for a specific Algolia index over a time period, with hourly or daily aggregation, including metrics such as record counts, query volumes, and processing times.

Get Users

Retrieve user profiles and affinities from Algolia advanced personalization using the EU endpoint.

Get Users Count

Retrieve the number of unique users for an index over a time range, including a daily breakdown, using the US Algolia Analytics endpoint.

Index Exists

Tool to check if an Algolia index exists.

Init Insights API Client

Return Insights client configuration for a selected region, including the application ID, API key, host, and cookie-setting metadata.

List AB Tests

List a page of A/B tests for the application in the DE analytics region, with optional index prefix or suffix filters.

List API Keys

List the application's main API keys with their permissions and restrictions for access-control review.

List Authentications

List a page of Algolia ingestion authentication resources in the US region, with optional type and platform filters.

List Destinations

List a page of Algolia ingestion destinations using the US endpoint, optionally filtering by type, authentication ID or transformation ID.

List Indices

Tool to list all indices and their metadata.

List Ingestion Tasks

List ingestion tasks using the US ingestion endpoint.

List Query Suggestions Configurations

Tool to retrieve all Query Suggestions configurations for an Algolia application.

List Task Runs

List Algolia Ingestion task runs using the US regional endpoint.

List Sources

Tool to list sources from the Algolia Ingestion API.

List Transformations

Tool to list all transformations in Algolia Ingestion API.

Partial Update Objects

Partially update multiple records in an index by objectID without replacing entire records.

Push Records to Task

Push records and a selected indexing action to a configured ingestion task by task ID, including actions to delete records, clear an index, or delete an index.

Replace All Rules

Batch save rules in an index, replacing existing rules by default.

Replace Task

Replace an Algolia Ingestion task with new configuration using the US regional API endpoint.

Restore API Key

Tool to restore a deleted API key within 72 hours of deletion.

Save Rule

Tool to create or replace a rule in an index.

Save Synonym

Tool to add or update a synonym in the specified index.

Save Synonyms

Batch create or replace synonyms in an Algolia index.

Search Authentications

Tool to search for authentication resources by IDs in Algolia.

Search Destinations

Search for multiple Algolia ingestion destinations by their IDs using the US endpoint.

Search Dictionary Entries

Tool to search dictionary entries in Algolia dictionaries.

Search Facet Values

Tool to search for values of a specified facet attribute.

Search Algolia Index

Tool to perform a search on a specified Algolia index.

Search Multiple Indices

Tool to perform searches across multiple indices in a single call.

Search Recommend Rules

Search Recommend rules in a specified index and model.

Search Sources

Search for multiple Algolia Ingestion API sources by their IDs using the US ingestion endpoint.

Search Synonyms

Search synonyms in a specified Algolia index, optionally matching a query or filtering by synonym type.

Search Transformations

Tool to search for transformations by IDs in Algolia Ingestion API.

Set Dictionary Settings

Tool to update dictionary settings for Algolia.

Set Personalization Strategy

Tool to define personalization strategy that controls how user behavior affects search results.

Set Index Settings

Tool to update an Algolia index's settings.

Stop AB Test

Tool to stop an A/B test by its unique identifier.

Try Transformation

Tool to try a transformation before creating it in Algolia.

Try Transformation Before Update

Tool to test a transformation before updating it in Algolia Ingestion API.

Update API Key

Tool to update the permissions and settings of an existing API key.

Update Authentication

Update the name or credentials of an Algolia ingestion authentication resource in the US region.

Update Query Suggestions Config

Tool to update an existing Query Suggestions configuration.

Update Destination

Update an Algolia ingestion destination using the US endpoint, including its configuration, name, type or associated transformations.

Update Dictionary Entries

Batch add or delete entries in an Algolia stopwords, plurals, or compounds dictionary.

Update Record Partially

Tool to add or update attributes in a single record.

Update Source

Tool to update a source in the Algolia Ingestion API.

Update Task

Partially update an Algolia Ingestion API task using the US ingestion endpoint.

Update Transformation

Tool to update an existing transformation in Algolia Ingestion API.

Validate Source

Tool to validate a source payload before creating it in Algolia.

Validate Source Before Update

Tool to validate a source update payload in the Algolia Ingestion API.

FAQ

Frequently asked questions

Start with Algolia.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Algolia tool your agent needs.Free to start.

Start building