> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tavily.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code

> Add Tavily web search, extraction, crawling, and research to Claude Code with the official Tavily plugin.

Give [Claude Code](https://code.claude.com) live web search, extraction, crawling, and research. The official [Tavily plugin](https://claude.com/marketplace/plugins/tavily) is listed in Anthropic's official plugin marketplace. It adds Tavily skills that run the [Tavily CLI](https://docs.tavily.com/documentation/tavily-cli.md).

**1. Install the plugin**

Paste the copied command into your terminal. Or, inside a Claude Code session, run:

```text theme={null}
/plugin install tavily@claude-plugins-official
```

This opens the plugin's details. Choose **Install for you** to use it in every project.

In the desktop app or VS Code, type `/plugins`, search for **Tavily**, and click **Install**.

**2. Load it**

Run `/reload-plugins`, or start a new session.

**3. Try it**

Ask naturally, or call a skill directly:

```text theme={null}
/tavily:tavily-search latest React Server Components changes
/tavily:tavily-research compare vector databases for RAG
```

If `tvly` isn't installed, Claude installs it on first use. Search and extract work without an account, up to a usage cap. Map, crawl, and research need you to sign in, so Claude runs `tvly login`, which opens your browser.

## What you get

| Skill | What it does |
| - | - |
| `tavily-search` | Search the web, extract URLs, and map or crawl a site |
| `tavily-research` | Run multi-source research with citations |
| `tavily-entity` | Enrich a company or person for a CRM, or a CSV of rows |
| `tavily-list` | Build a deduplicated table of matches, with a cap |
| `tavily-monitor` | Set up a search or extraction that runs on a cadence |
| `tavily-sdk` | Build Tavily into your own code |

## More options

> [accordion] Install for your whole team
>
> Install the plugin at project scope. This records it in `.claude/settings.json`, which you commit:
>
> ```bash theme={null}
> claude plugin install tavily@claude-plugins-official --scope project
> ```
>
> Each collaborator runs the same command once to download the plugin.

> [accordion] Connect the MCP server instead
>
> Use Tavily's hosted [MCP server](https://docs.tavily.com/documentation/mcp.md) if you'd rather have MCP tools (`tavily_search`, `tavily_extract`, and more) than CLI-based skills:
>
> ```bash theme={null}
> claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/
> ```
>
> Run `/mcp`, select **tavily**, and sign in. To skip OAuth, add `--header "Authorization: Bearer YOUR_TAVILY_API_KEY"`. For limited access without an account, add `--header "X-Tavily-Access-Mode: keyless"` instead. See [keyless access](https://docs.tavily.com/documentation/keyless.md).

> [accordion] Run the MCP server locally
>
> Requires [Node.js](https://nodejs.org/en/download) 20+ and a [Tavily API key](https://app.tavily.com):
>
> ```bash theme={null}
> claude mcp add --scope user tavily-local -e TAVILY_API_KEY=YOUR_TAVILY_API_KEY -- npx -y tavily-mcp@latest
> ```
>
> Run `/mcp` to confirm `tavily-local` is connected.

> [accordion] Install the skills without the plugin
>
> Install the [Tavily CLI](https://docs.tavily.com/documentation/tavily-cli.md), sign in, and install the [Agent Skills](https://docs.tavily.com/documentation/agent-skills.md) in one step:
>
> ```bash theme={null}
> npx @tavily/cli init --agent claude-code
> ```
>
> To install the skills for one project only, run `npx skills add tavily-ai/skills --skill '*' --agent claude-code` inside that project instead.
>
> Start a new session to load them. Add `--global` to install them for all projects.

## Troubleshooting

* **The install command can't find `claude-plugins-official`.** Claude Code adds this marketplace the first time you start an interactive session. On a new machine or in CI, add it first: `claude plugin marketplace add anthropics/claude-plugins-official`.
* **The skills don't appear.** Run `/reload-plugins`, then check that `tavily` is enabled under `/plugin` → **Installed**.
* **Map, crawl, or research says you're not signed in.** Run `tvly login`, or set `TAVILY_API_KEY`. Check the state with `tvly --status`.
* **Search stops after a few requests.** You've reached the keyless cap. Run `tvly login` to keep going.

## Resources

* [Tavily plugin](https://claude.com/marketplace/plugins/tavily) · [skills repository](https://github.com/tavily-ai/skills)
* [Claude Code plugin docs](https://code.claude.com/docs/en/discover-plugins) · [Claude Code MCP docs](https://code.claude.com/docs/en/mcp)
* [Claude (web & desktop)](https://docs.tavily.com/documentation/integrations/claude.md) · [Tavily MCP server](https://docs.tavily.com/documentation/mcp.md) · [Tavily CLI](https://docs.tavily.com/documentation/tavily-cli.md)
