How to add OpenAPI MCP Server to Claude Desktop

Search and explore any OpenAPI spec in simple language, via oapis.org. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 895★ · http · no auth

Claude Desktop config for OpenAPI MCP Server

{
  "mcpServers": {
    "openapi-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://openapi-mcp.openapisearch.com/mcp"
      ]
    }
  }
}

Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the OpenAPI MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm OpenAPI MCP Server's tools appear under the 🔌 tools menu.

Before you start

An MCP-compatible client (e.g. Claude Desktop or Cursor)
Network access to the hosted endpoint https://openapi-mcp.openapisearch.com/mcp

What OpenAPI MCP Server can do in Claude Desktop

OpenAPI overview

Get a plain-language overview/summary of a given OpenAPI specification (resolved from an OpenAPI identifier).

Operation details

Retrieve details about specific API operations/endpoints from a spec, explained in simple language, for both JSON and YAML formats.

Security

Hosted, remote MCP server: requests for OpenAPI specs are processed via the oapis.org / openapisearch.com service rather than locally. No authentication is documented for the public MCP endpoint.

OpenAPI MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the OpenAPI MCP Server config there under the "mcpServers" key and restart the client.

Is OpenAPI MCP Server safe to use with Claude Desktop?

Hosted, remote MCP server: requests for OpenAPI specs are processed via the oapis.org / openapisearch.com service rather than locally. No authentication is documented for the public MCP endpoint.

Do I need to install anything locally?

No. It is a hosted remote MCP server. Point your client at the MCP URL https://openapi-mcp.openapisearch.com/mcp, or use the install link in the README.

Which clients are supported?

The README states it has been tested with Claude Desktop and Cursor, and notes that other clients can use the same MCP URL.

Can I run it myself?

Yes. The repo supports local testing with `wrangler dev` (it is a Cloudflare Worker) and the MCP inspector via `npx @modelcontextprotocol/inspector`.

View repo Full OpenAPI MCP Server page