[metadata]
description: Install and configure the DocSearch MCP server.
docsearch:docusaurus_tag: docs-default-current
docsearch:language: en
docsearch:version: current
docusaurus_locale: en
docusaurus_tag: docs-default-current
docusaurus_version: current
generator: Docusaurus v3.10.2
google-site-verification: 23yIHmCD_xnJb_6e3s-w7M29Kydahk-d86ObMWOrvRg
og:description: Install and configure the DocSearch MCP server.
og:image: https://docsearch.algolia.com/img/og_image.png
og:locale: en
og:title: Install DocSearch MCP | DocSearch by Algolia
og:url: https://docsearch.algolia.com/docs/mcp/installation
twitter:card: summary_large_image
twitter:image: https://docsearch.algolia.com/img/og_image.png
viewport: width=device-width,initial-scale=1

[canonical-links]
https://docsearch.algolia.com/docs/mcp/installation

[document-links]
/
Agent Studio: /docs/agent-studio/getting-started
Algolia Blog: https://algolia.com/blog/
Algolia Crawler: /docs/create-crawler
DOCSEARCH by: /
Discord: https://discord.com/invite/W7kYfh7FKQ
DocSearch v3: /docs/v3/docsearch
DocSearch v4: /docs/v4/docsearch
DocSearch v5: /docs/packages/overview
Documentation: /docs/what-is-docsearch
Edit this page: https://github.com/algolia/docsearch/edit/main/packages/website/docs/mcp/installation.mdx
FAQ: /docs/docsearch-program
Getting Started: /docs/what-is-docsearch
GitHub: https://github.com/algolia/docsearch
Installation: /docs/mcp/installation
Introduction: /docs/what-is-docsearch
Issues: https://github.com/algolia/docsearch/issues
Legacy (v1.x - v2.x): /docs/legacy/dropdown
Legacy (v3.x): /docs/v3/what-is-docsearch
Legacy (v4.x): /docs/v4/what-is-docsearch
MCP: /docs/mcp/overview
MCP: https://docsearch.algolia.com/mcp
Migrate from v4: /docs/migrating-from-v4
Miscellaneous: /docs/migrating-from-legacy
Next Usage: /docs/mcp/usage
Overview: /docs/mcp/overview
Packages: /docs/packages/overview
Previous Overview: /docs/mcp/overview
Privacy: https://www.algolia.com/policies/privacy/
Requirements, tips, FAQ: /docs/crawler
Sign up: https://dashboard.algolia.com/users/sign_up?selected_plan=docsearch&utm_source=docsearch.algolia.com&utm_medium=referral&utm_campaign=docsearch&utm_content=apply
Stable (v5.x): /docs/mcp/installation
Troubleshooting: /docs/mcp/usage#troubleshooting
Twitter: https://twitter.com/docsearch_
Under the hood: /docs/how-does-it-work
Usage: /docs/mcp/usage
choose a package: /docs/packages/overview
https://cursor.com/en-US/install-mcp?name=algolia-docsearch&config=eyJ1cmwiOiJodHRwczovL21jcC5hbGdvbGlhLmNvbS8xL2RvY3NlYXJjaC9tY3AifQ%3D%3D
https://github.com/algolia/docsearch

[structured-data]
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","item":"https://docsearch.algolia.com/docs/mcp/installation","name":"Installation","position":1}]}

[content]
Install DocSearch MCP | DocSearch by Algolia
Skip to main content
DocSearch 5.0.0 is available.
Migrate from v4
or
choose a package
DOCSEARCH
by
Documentation
MCP
Stable (v5.x)
Stable (v5.x)
Legacy (v4.x)
Legacy (v3.x)
Legacy (v1.x - v2.x)
Go on, give it a search...
Sign up
Introduction
Packages
Agent Studio
MCP
Overview
Installation
Usage
Algolia Crawler
Requirements, tips, FAQ
Under the hood
Miscellaneous
MCP
Installation
Version: Stable (v5.x)
On this page
Install DocSearch MCP
DocSearch MCP is a remote MCP server. Point any MCP-compatible client at this endpoint — no authentication required:
https://mcp.algolia.com/1/docsearch/mcp
The fastest path to getting started is the
DocSearch CLI
— one command that configures your client for you. Prefer to set things up yourself? Install it as a
plugin
(ships the MCP server plus client guidance like rules, skills, and commands) or
manually
(just the MCP server config). Pick your client below.
Connect DocSearch MCP
Pick your client to get the install steps
Cursor
Claude
Codex
ChatGPT
OpenCode
Pi
VS Code
Windsurf
Zed
Conductor
Antigravity
Other clients
One-command install
Adds the server, rules, and skills to Cursor
$
npx @docsearch/cli setup
--cursor
Copy
Cursor
Plugin · 1-click · manual
plugin
manual
Install the Cursor plugin package from the DocSearch repository:
Plugin package
Copy
mcp/plugins/docsearch/cursor/algolia-docsearch
It ships the MCP server, a rule, and a skill that teach Cursor when and how to call the DocSearch tools.
Install a client plugin
​
Plugins include the MCP connection and instructions that teach the client when and how to use DocSearch.
Claude Code
​
Run these commands inside Claude Code:
/plugin marketplace add algolia/docsearch
/plugin install algolia-docsearch@algolia-docsearch-marketplace
The plugin adds the MCP server, a skill, and the
/algolia-docsearch:docs
command.
Cursor
​
The Cursor plugin package is in the DocSearch repository at:
mcp/plugins/docsearch/cursor/algolia-docsearch
It includes the MCP server configuration, a rule, and a skill.
Configure a supported agent manually
​
Manual configuration adds the server but doesn't install the rules and skills supplied by the CLI or plugins.
Cursor
Claude Code
Codex
OpenCode
Gemini CLI
Add this entry to
~/.cursor/mcp.json
for user-level configuration or
.cursor/mcp.json
for project configuration:
.cursor/mcp.json
{
"mcpServers"
:
{
"algolia-docsearch"
:
{
"url"
:
"https://mcp.algolia.com/1/docsearch/mcp"
}
}
}
Add the user-level remote server with the Claude Code CLI:
claude mcp add --scope user --transport http algolia-docsearch https://mcp.algolia.com/1/docsearch/mcp
Add the remote server with the Codex CLI:
codex mcp add algolia-docsearch --url https://mcp.algolia.com/1/docsearch/mcp
You can also add the URL under
[mcp_servers.algolia-docsearch]
in
~/.codex/config.toml
.
Add this entry to
opencode.json
or
opencode.jsonc
:
opencode.json
{
"$schema"
:
"https://opencode.ai/config.json"
,
"mcp"
:
{
"algolia-docsearch"
:
{
"type"
:
"remote"
,
"url"
:
"https://mcp.algolia.com/1/docsearch/mcp"
,
"enabled"
:
true
}
}
}
Add this entry to
.gemini/settings.json
for project configuration or
~/.gemini/settings.json
for user-level configuration:
.gemini/settings.json
{
"mcpServers"
:
{
"algolia-docsearch"
:
{
"httpUrl"
:
"https://mcp.algolia.com/1/docsearch/mcp"
}
}
}
Connect another MCP client
​
You can also connect clients that support remote HTTP MCP servers. Use these connection methods:
Claude Desktop
: Add a custom connector named
Algolia DocSearch
with the endpoint URL.
ChatGPT
: Add a no-auth custom connector. Availability depends on the plan and workspace settings.
Pi
: Install an MCP extension or adapter before adding the server.
VS Code
: Add a remote server to the workspace or user MCP configuration. The tools are available in Copilot Chat agent mode.
Windsurf
: Add the endpoint to the Cascade MCP configuration, then restart Windsurf.
Zed
: Add the endpoint as a context server.
Conductor
: Configure the server in the selected Claude Code, Codex, or Cursor host. Conductor doesn't use a separate MCP configuration for those sessions.
Antigravity
: Add the endpoint through
Manage MCP Servers > View raw config
, then refresh the installed servers.
Configuration keys differ by client. Follow the client's MCP documentation and keep the server name
algolia-docsearch
and the endpoint URL unchanged.
Verify the installation
​
Ask your client to search public documentation:
Use DocSearch MCP to find the Next.js middleware matcher documentation.
Confirm that the client calls a tool whose name starts with
algolia_docsearch_
and returns source links from the selected documentation.
If verification fails, see
Troubleshooting
.
Edit this page
Last updated
on
Aug 6, 2026
by
Paul Jankowski
Previous
Overview
Next
Usage
Install a client plugin
Claude Code
Cursor
Configure a supported agent manually
Connect another MCP client
Verify the installation
Docs
Getting Started
FAQ
DocSearch v3
DocSearch v4
DocSearch v5
DocSearch
Sign up
Issues
Privacy
Community
Discord
Social
GitHub
Twitter
Algolia Blog
DOCSEARCH
by
2015–2026 — Built with
♥
by Algolia
