Perplexity · Codex

Add the Perplexity MCP server to Codex

Real-time web search and research through the Perplexity API.

Official serverLocalWeb search & scraping

1. Add the server

Run in your terminal

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

2. Sign in

Run codex mcp login <name> to complete OAuth for a remote server. Perplexity runs locally; set any credentials Perplexity asks for before starting Codex.

3. Try it

Ask Codex for something Perplexity can do. Real-time web search and research through the Perplexity API. 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 Perplexity MCP server to Codex?
Run: # ~/.codex/config.toml …. Run codex mcp login <name> to complete OAuth for a remote server.
Is this the official Perplexity MCP server?
Yes. It is published by Perplexity as ai.perplexity/mcp-server in the official MCP registry.
Does the Perplexity MCP server need an API key?
It runs locally from a package. See Perplexity's docs for any credentials it needs.

Links

Perplexity in other clients

More web search & scraping for Codex

Work at Perplexity?

Feature Perplexity 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.