sheets-mcp docs
Guides

Connect Claude Desktop

Step-by-step guide to wiring sheets-mcp into Claude Desktop via OIDC.

Prerequisites

Steps

  1. Open the Claude Desktop config file.

    macOS:

    open ~/Library/Application\ Support/Claude/

    Windows:

    %APPDATA%\Claude\

    Open claude_desktop_config.json in your editor. If it does not exist, create it.

  2. Add the sheets-mcp server.

    {
      "mcpServers": {
        "sheets-mcp": {
          "url": "https://sheets-mcp-xi.vercel.app/api/mcp"
        }
      }
    }

    If you already have other MCP servers, add sheets-mcp as a new key inside mcpServers.

  3. Restart Claude Desktop.

    Fully quit and relaunch Claude Desktop. On restart, Claude detects the new MCP server and initiates the OIDC auth handshake — it discovers the authorization endpoint from /.well-known/oauth-authorization-server automatically.

  4. Complete Google OAuth consent.

    Claude opens a browser window to the authorization endpoint. Sign in with the Google account connected to sheets-mcp and grant the requested scopes.

  5. Test a tool.

    Ask Claude to list spreadsheets. If auth is successful, it should return a live sheet list immediately.


What to do next

On this page