Skip to content
MCP server

DocQuery

Read-only MCP over your Excel or Airtable tables joined to the PDFs beside them

Status and history

Answered our latest tool-list check 21 hours ago with 4 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.0.1
Listing updated
3 days ago

About DocQuery

DocQuery is a freemium MCP server for files and documents. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://docquery.io/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "docquery": {
      "url": "https://docquery.io/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (4)

Read directly from the server.

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

What it does

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

Pricing

Freemium

Free plan (5 documents, 10,000 rows); Starter and Pro plan prices not published

Prices change. Check docquery.io before you buy.

DocQuery 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 to DocQuery

  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