tavily-mcp MCP server in Claude Desktop real web search for your chats.

Claude Desktop can't browse the web on its own. tavily-mcp (2.1k GitHub stars) gives it a search tool over the Tavily API — one JSON edit, one restart, and Claude can pull in live results mid-conversation.

tavily-mcp wraps Tavily's web search API as an MCP server, so Claude Desktop can run real searches instead of reasoning from training data. It ships as an npm package and runs locally over stdio — Claude Desktop launches it as a subprocess each time the app starts.

The whole setup is one entry in claude_desktop_config.json plus a Tavily API key. This page covers the exact file paths, a config you can paste, and what to check when the hammer icon doesn't show up.

Before you start

You need two things: Node.js installed (the server runs via npx, so node must be on your PATH) and a Tavily API key. Sign up at tavily.com, copy the key from your dashboard — it starts with tvly-. Tavily's own API has a free tier for the key itself; check their site for current limits.

tavily-mcp is open source at github.com/tavily-ai/tavily-mcp if you want to read what it does before giving it a key.

Edit claude_desktop_config.json

Claude Desktop reads MCP servers from a single JSON file. On macOS it lives at ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows it's %APPDATA%\Claude\claude_desktop_config.json. If the file doesn't exist yet, create it — or open it from Claude Desktop via Settings > Developer > Edit Config.

Add tavily-mcp under the mcpServers key:

claude_desktop_config.json

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp"],
      "env": {
        "TAVILY_API_KEY": "tvly-YOUR_API_KEY"
      }
    }
  }
}

Restart and verify

Claude Desktop only reads the config at launch, so quit the app completely — on macOS that means Cmd+Q, not just closing the window — and reopen it. A tools indicator appears near the message box when servers load; click it and you should see Tavily's search tools listed.

Test it with a prompt that needs fresh data, like "search for this week's Node.js release notes." Claude will ask permission to run the tool the first time, then return results with source URLs.

Troubleshooting

Server not listed after restart: the most common cause is invalid JSON — a trailing comma or unescaped backslash in a Windows path. Run the file through a JSON validator. Also confirm you edited the file Claude actually reads; ~/Library/Application Support (with the space) is easy to mistype.

Tools listed but calls fail: check the TAVILY_API_KEY value — a missing or expired key fails at call time, not at startup. If npx itself fails, your GUI app may not inherit your shell's PATH; installing Node via the official installer rather than a version manager usually fixes it. Claude Desktop writes MCP logs to ~/Library/Logs/Claude/ on macOS (mcp-server-tavily-mcp.log), which shows the server's stderr.

Pricing and discovery context

tavily-mcp itself is free, open-source software — the metered part is the Tavily API behind it. You can see the server's live tool list and listing details on Loomal at https://loomal.ai/marketplace/tavily-mcp.

Loomal indexes MCP servers so agents can discover and pay for tools per call over x402 — useful context if you're evaluating search servers beyond your own desktop.

FAQ

How do I install tavily-mcp in Claude Desktop?

Add a tavily-mcp entry under mcpServers in claude_desktop_config.json with command npx, args ["-y", "tavily-mcp"], and your TAVILY_API_KEY in env. Then fully quit and relaunch Claude Desktop — it only reads the config at startup.

Where is Claude Desktop's MCP config file?

On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. You can also open it from inside the app via Settings > Developer > Edit Config.

Why doesn't Tavily appear after I edited the config?

Usually one of three things: invalid JSON syntax (validate the file), Claude Desktop wasn't fully quit and relaunched, or npx isn't on the PATH the app sees. Check ~/Library/Logs/Claude/ on macOS for the server's error output.

Does tavily-mcp cost anything?

The server software is free and open source (github.com/tavily-ai/tavily-mcp). Usage is billed by Tavily's API under your key — they offer a free tier; check tavily.com for current quotas.

tavily-mcp in Cursor tavily-mcp in VS Code (Copilot)Search MCP servers Connect Claude Desktop to any MCP server stdio transport

Browse more MCP servers for Claude Desktop.

Search, scraping, databases — every listing on Loomal shows its live tool list.

Open the marketplace