# SheetDB

> SheetDB is a freemium MCP server for databases. Let an assistant read and write the Google Sheets behind your SheetDB APIs. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $25.49 a month
- **Platforms:** API, Web
- **Website:** https://sheetdb.io/mcp
- **MCP Registry name:** io.sheetdb/sheetdb
- **Categories:** databases, productivity
- **Listing updated:** 2026-11-15

## About

Ten tools sit on top of spreadsheets already connected to SheetDB: list APIs, describe a sheet, read, search, add, update and delete records, and create a new API from a spreadsheet URL. A call follows the same path as an HTTP request, so it uses the same cache, per-API permissions, rate limits and Google quota handling.

Writes are guarded. Updates above an approval threshold, or on any API where you require approval, are only proposed as a pending action, and deletes return a preview first; a delete runs at once only if you switched approval off for that API. Each connected assistant appears in the SheetDB panel as an agent connection with client name, date and last use.

Sign-in is OAuth with the Google account you use for SheetDB. On ChatGPT, the page says Pro gets read-only access to a custom MCP server, while Business and Enterprise/Edu get reads and writes.

## Features

- **Ten sheet tools:** List, describe, read, search, add, update and delete records, or create an API.
- **Approval for risky writes:** Large updates and deletes wait as pending actions until confirmed.
- **Per-API permissions:** The agent only does what each API's permissions allow.
- **Same rules as REST:** Cache, rate limits and quota handling match the HTTP API.
- **Agent connections panel:** See each connected assistant with its last use.

## Good for

- Ask which customers in a sheet have not paid
- Append new leads to a CRM tab
- Search rows with AND/OR conditions
- Turn a spreadsheet URL into an API from chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sheetdb https://sheetdb.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sheetdb.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sheetdb": {
      "url": "https://sheetdb.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sheetdb": {
      "type": "http",
      "url": "https://sheetdb.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sheetdb": {
      "serverUrl": "https://sheetdb.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sheetdb": {
      "type": "http",
      "url": "https://sheetdb.io/mcp"
    }
  }
}
```

## Tools

- `list_apis`: List your APIs and what the agent may do with each
- `describe_api`: Show tabs, columns, record count and sample records
- `read_records`: Read records page by page from a tab
- `search_records`: Find records matching AND or OR conditions
- `create_records`: Append records to a sheet
- `update_records`: Change matching records, or propose the change for approval
- `delete_records`: Preview matching records as a pending delete
- `confirm_pending_action`: Run an approved pending action

## FAQ

### Is there a free plan?

Yes, the free plan has 2 spreadsheet APIs and 500 requests a month.

### Will it delete rows without asking?

No. Deletes return a preview as a pending action unless you turned approval off for that API.

### Do I need a Google Cloud project?

No; you sign in with the Google account you already use for SheetDB.

### Does every tool count as a request?

list_apis and confirm_pending_action do not; the others count like an HTTP request.

### Is SheetDB free?

SheetDB has a free plan, with paid plans for more usage or features. Paid plans start at $25.49 a month.

### How do I add SheetDB to Claude Code?

Run this command in your terminal: claude mcp add --transport http sheetdb https://sheetdb.io/mcp

### What are the best alternatives to SheetDB?

The closest alternatives to SheetDB are Ha MCP, Concord MCP, Midplane, note1 and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/sheetdb
