Skip to content
MCP server

Spreadsheet DB

SQLite-authoritative entity database with an async Google Sheets projection for AI agents.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.1
Listing updated
4 days ago

About Spreadsheet DB

Spreadsheet DB is an open-source MCP server for databases. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add spreadsheet-db-mcp --env GOOGLE_APPLICATION_CREDENTIALS='<GOOGLE_APPLICATION_CREDENTIALS>' -- npx -y spreadsheet-db-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "spreadsheet-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spreadsheet-db-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "spreadsheet-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spreadsheet-db-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "spreadsheet-db-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "spreadsheet-db-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "spreadsheet-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spreadsheet-db-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "spreadsheet-db-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spreadsheet-db-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>"
      }
    }
  }
}

Configuration

  • HIKOUTEI_MCP_CONFIGPath to the entity configuration file (hikoutei.config.json). Optional; the server also looks for ./hikoutei.config.json in the working directory.
  • HIKOUTEI_SYNC_SPREADSHEET_URLGoogle Sheets spreadsheet URL. Absent means local-only mode (no Google contact); when set, the Google Sheets projection is enabled and GOOGLE_APPLICATION_CREDENTIALS must also be set.
  • GOOGLE_APPLICATION_CREDENTIALSPath to a Google service-account key file (JSON) used for the Sheets projection. Only needed when HIKOUTEI_SYNC_SPREADSHEET_URL is set.

Pricing

Open source

Spreadsheet DB FAQ

Is Spreadsheet DB free?

Yes. Spreadsheet DB is open source, so you can use and self-host it for free.

How do I add Spreadsheet DB to Claude Code?

Run this command in your terminal: claude mcp add spreadsheet-db-mcp --env GOOGLE_APPLICATION_CREDENTIALS='<GOOGLE_APPLICATION_CREDENTIALS>' -- npx -y spreadsheet-db-mcp

What are the best alternatives to Spreadsheet DB?

The closest alternatives to Spreadsheet DB are Midplane, ASTra, CARTESIAN ECU, Invoices and SigPen.

Alternatives to Spreadsheet DB

  1. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  2. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  3. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  4. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  5. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media