GraphQL MCP

The quickest way to install and configure mcp-graphql for Claude is via the Smithery CLI, which handles the claude_desktop_config.json update automatically.

npx -y @smithery/cli install mcp-graphql --client claude

Add the mcp-graphql server to your Claude Desktop config, setting the ENDPOINT environment variable to your GraphQL API URL. The server runs directly via npx with no install step.

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql"],
      "env": {
        "ENDPOINT": "http://localhost:4000/graphql"
      }
    }
  }
}

Pass a JSON string of HTTP headers in the HEADERS environment variable. This supports Bearer tokens, API keys, or any custom header your GraphQL endpoint requires.

{
  "mcpServers": {
    "mcp-graphql": {
      "command": "npx",
      "args": ["mcp-graphql"],
      "env": {
        "ENDPOINT": "https://api.example.com/graphql",
        "HEADERS": "{\"Authorization\": \"Bearer your-token-here\"}"
      }
    }
  }
}

By default, mcp-graphql blocks mutation execution for safety. Set ALLOW_MUTATIONS=true in the env block to permit write operations through Claude.

"env": {
  "ENDPOINT": "http://localhost:4000/graphql",
  "ALLOW_MUTATIONS": "true"
}

Restart Claude Desktop to load the new server. Ask Claude to introspect the schema — it should describe your API's types, queries, and mutations using the introspect-schema tool.