🔍 Algolia Node.js MCP

🚀 Hosted MCP Now Available We’re excited to announce that a Hosted MCP is now available! This makes it easier than ever to connect your external data and APIs to ChatGPT — no setup or hosting required.

👉 Learn more and get started in our documentation.

https://github.com/user-attachments/assets/c36a72e0-f790-4b3f-8720-294ab7f5f6eb

This repository contains experimental Model Context Protocol (or MCP) servers for interacting with Algolia APIs. We're sharing it for you to explore and experiment with. Feel free to use it, fork it, or build on top of it — but just know that it's not officially supported by Algolia and isn't covered under our SLA.

We might update it, break it, or remove it entirely at any time. If you customize or configure things here, there's a chance that work could be lost. Also, using MCP in production could affect your Algolia usage.

If you have feedback or ideas (even code!), we'd love to hear it. Just know that we might use it to help improve our products. This project is provided "as is" and "as available," with no guarantees or warranties. To be super clear: MCP isn't considered an "API Client" for SLA purposes.

✨ Quick Start

1. Download the latest release from our GitHub Releases

2. Authenticate with your Algolia account

3. Connect to Claude Desktop

4. Start asking questions about your Algolia data!

🚀 Features

Algolia Node.js MCP enables natural language interactions with your Algolia data through Claude Desktop. This implementation allows you to:

• Search and manipulate indices with natural language

• Analyze search metrics and performance

• Monitor application status and incidents

• Visualize your data with AI-generated charts and graphs

• Integrate seamlessly with Claude Desktop through the Model Context Protocol

🔮 Usage Examples

Here are some example prompts to get you started:

Account Management

Applications

Search & Indexing

Analytics & Insights

Monitoring & Performance

📦 Installation

macOS

1. Download the latest release from GitHub Releases

2. Extract the .zip file

3. From your terminal, remove quarantine flag to allow execution:

   xattr -r -d com.apple.quarantine <path_to_executable>

   Note: This step is necessary as the executable is not signed with an Apple Developer account. If you prefer, you can build from source instead.

4. Run the authentication command:

   <path_to_executable> authenticate

   This will open your browser to authenticate with the Algolia Dashboard.

Windows & Linux

Coming soon.

⚙️ Configuration

Claude Desktop Setup

1. Open Claude Desktop settings

2. Add the following to your configuration:

   { "mcpServers": { "algolia-mcp": { "command": "<path_to_executable>" } } }

3. Restart Claude Desktop

CLI Options

Available Commands

Server Options

🛠 Development

Requirements

• Node.js 22 or higher

• npm

Setup Development Environment

1. Clone the repository:

   git clone https://github.com/algolia/mcp-node cd mcp-node npm install

2. Configure Claude Desktop for development:

   { "mcpServers": { "algolia-mcp": { "command": "<PATH_TO_BIN>/node", "args": [ "--experimental-strip-types", "--no-warnings=ExperimentalWarning", "<PATH_TO_PROJECT>/src/app.ts" ] } } }

Note: You'll need to restart Claude Desktop after making code changes.

Build

Testing and Debugging

Use the MCP Inspector for testing and debugging:

1. Run the debug script:

   cd mcp-node npm run debug

2. Open http://127.0.0.1:6274/ in your browser

3. Click Connect to start the server

4. Send test requests through the inspector interface

🔧 Troubleshooting

Common Issues

• "App not responding" error: Ensure you've removed the quarantine attribute on macOS

• Authentication failures: Try logging out and authenticating again

• Claude can't access tools: Verify your MCP configuration in Claude Desktop settings

Logs and Diagnostics

Log files are stored in:

• macOS: ~/Library/Logs/algolia-mcp/

• Windows: %APPDATA%\algolia-mcp\logs\

• Linux: ~/.config/algolia-mcp/logs/

👥 Contributing

We welcome contributions to Algolia Node.js MCP! Here's how you can help:

1. Fork the repository

2. Create a feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a pull request

License

Algolia Node.js MCP is MIT licensed.