# DocQuery

> DocQuery is a freemium MCP server for files and documents. Read-only MCP over your Excel or Airtable tables joined to the PDFs beside them. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API
- **Website:** https://docquery.io/mcp-server
- **MCP Registry name:** io.docquery/docquery
- **Categories:** files and documents, databases
- **Listing updated:** 2026-11-14

## About

DocQuery treats a spreadsheet and the documents that go with it as one relational dataset. You connect an Excel workbook or Airtable base, upload related invoices or contracts, and link them with a foreign key. The hosted server then lets an assistant list tables, look up rows and follow relations, with every workspace scoped by its API key.

Provenance is a notable feature. Rows extracted from uploaded documents carry a source_document with the document ID and filename, and query_table adds source_page when the PDF page or slide is known. Word, ODT and RTF rows leave the page empty, and CSV, Excel, Google Sheets and Airtable tables have no source document. The site tells assistants to cite filename and page when quoting a value and not to invent a page. DocQuery does not keep the original file bytes.

Claude.ai and ChatGPT connect by pasting the URL and signing in, with read-only access. Cursor, Claude Code and Claude Desktop use a bearer API key. A public read-only demo key with sample customers and invoices lets you test before signing up.

## Features

- **Relational joins:** Link spreadsheet tables and extracted document tables by foreign keys.
- **Source citations:** Extracted rows include source document and page where known.
- **Read-only tools:** Four tools list and query data; none create, change or delete it.
- **Schema resource and prompts:** Exposes the workspace schema plus schema_overview, find_rows and count_by prompts.
- **Keyless connectors:** Claude.ai and ChatGPT sign in through the browser instead of using a key.
- **Demo key:** A public read-only key with sample data tests the server.

## Good for

- Ask which customers have unpaid invoices and how much they owe
- Cross-check invoice PDFs against a spreadsheet
- Count rows grouped by a column
- Cite the page a contract value came from

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http docquery https://docquery.io/api/v1/mcp
```

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

```sh
https://docquery.io/api/v1/mcp
```

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

```json
{
  "mcpServers": {
    "docquery": {
      "url": "https://docquery.io/api/v1/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "docquery": {
      "serverUrl": "https://docquery.io/api/v1/mcp"
    }
  }
}
```

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

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

## Tools

- `list_tables`: List all tables in the workspace. Call this first to learn table and column slugs. Returns slug, name, row_count, and columns (slug, name, type, primary_key) for each table. Document-extracted tables include source_document {id, filename, url}. source_document is null for CSV, Excel, Google Sheets, and Airtable. url is the signed-in document page; original file bytes are not stored, so it is not a
- `list_relations`: List the relations (foreign keys) between tables in the workspace. Each relation has from and to as "table_slug.column_slug" and a kind. Use it to find which columns link two tables before calling related_rows. Read-only; returns an empty list when no relations are defined.
- `query_table`: Read rows from a table. Optional filter is an exact-match map of column slug => value; optional search is a case-insensitive substring match across all cells. Returns source_document for the table (null for spreadsheets and Airtable). Each row includes source_page: the 1-based PDF page, PowerPoint slide, or Google Slides slide the row was extracted from, or null when the page is unknown (Word, ODT
- `related_rows`: Follow a relation from a source table to the rows it links to. Given a column on `table_slug` that participates in a relation and a `value` (usually a cell from a source row), returns the matching rows in the linked table. Works in both directions. Each linked table includes source_document when it came from an uploaded document, and each row includes source_page (or null). Cite the filename and p

## FAQ

### Can the assistant change my data?

No. The tools are read-only, and the Claude.ai and ChatGPT connector cannot create, change or delete data.

### Is there a free plan?

Yes: 5 documents and 10,000 rows with no card. Starter allows 50 documents and 250,000 rows.

### Does it keep my original files?

No. DocQuery says it does not keep the original file bytes.

### Which clients need an API key?

Cursor, Claude Code and Claude Desktop use a bearer key; Claude.ai and ChatGPT sign in instead.

### Is DocQuery free?

DocQuery has a free plan, with paid plans for more usage or features.

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

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

### What are the best alternatives to DocQuery?

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

## Alternatives

- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.

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