Brave · Codex

Add the Brave Search MCP server to Codex

Web, image, video and news results plus AI summaries from Brave's independent index.

Official serverLocalWeb search & scraping

1. Add the server

Run in your terminal

# ~/.codex/config.toml
[mcp_servers.brave_search]
command = "npx"
args = ["-y", "@brave/brave-search-mcp-server"]

[mcp_servers.brave_search.env]
BRAVE_API_KEY = "<your BRAVE_API_KEY>"

2. Sign in

Run codex mcp login <name> to complete OAuth for a remote server. Brave Search runs locally and needs BRAVE_API_KEY. Replace the placeholder values above with your own before starting Codex.

3. Try it

Ask Codex for something Brave Search can do. Web, image, video and news results plus AI summaries from Brave's independent index. Approve the first tool call and check the result before allowing write actions automatically.

  • · Each server is a [mcp_servers.<name>] table in config.toml.
  • · Use enabled_tools or disabled_tools to keep the tool list short.

FAQ

How do I add the Brave Search MCP server to Codex?
Run: # ~/.codex/config.toml …. Run codex mcp login <name> to complete OAuth for a remote server.
Is this the official Brave Search MCP server?
Yes. It is published by Brave as io.github.brave/brave-search-mcp-server in the official MCP registry.
Does the Brave Search MCP server need an API key?
Yes. It runs locally and requires BRAVE_API_KEY.

Links

Brave Search in other clients

More web search & scraping for Codex

Work at Brave?

Feature Brave Search across the directory and its category from $49/month.

Feature this server

Reviewed Oct 5, 2026. Command generated from the registry record and checked against Codex's documented syntax.