1. Docs
2. /
3. Tool reference
4. /
5. Tables
6. /
7. readTable

Tables

readTable

Read Table

Read a table you own: its meta, its tabs (sheets), and the active tab's columns (type + order) and rows.

read

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "show me the table", and it calls readTable.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "tableId": "<tableId>"
  },
  "name": "readTable"
}

Arguments

• changedSincenumberoptionalThe cursor a previous readTable returned. Answers with only the rows changed after it, or changed: false.
• tabIdstringoptionalOptional tab (sheet) id from listTabs/createTab. Omit to use the table's default tab.
• tableIdstringrequiredThe table id.

Returns

To watch a table cheaply, pass it back as changedSince: an unchanged table answers changed: false with no rows; a changed one returns only the rows changed after it (rowCount is the tab's…

Ask for it

The Cloud routes these requests to this verb.

• show me the table
• read my expenses
• what's in this spreadsheet
• what changed in the table

Pair it with

The verbs that finish the job.

• listTabs
• queryTable
• computeSummary

Questions

• What does readTable do?

  Read a table you own: its meta, its tabs (sheets), and the active tab's columns (type + order) and rows. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use readTable from Claude or ChatGPT?

  Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "show me the table", and it calls readTable.

• Is readTable safe to let an AI call?

  readTable is read-only: it changes nothing.

Connect

One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.