---
title: "chart_get"
description: "Pass `tableId` and optional `name`."
---

| Operation | OAuth scope | Description |
| :-- | :-- | :-- |
| `chart_get` | `files:read` | Pass `tableId` and optional `name`. Returns saved definitions and `points: [{x, series, y}]` over current readable, non-trashed records. Count counts records; numeric aggregates ignore null/missing values. Date buckets use UTC, with Monday-start weeks. Invalidated columns return `status: "stale"`, `reason` and no points. More than 200 points fails with `too_large`; narrow filters or grouping. |

Group: [Tables, records and exports](/docs/en-US/agents/mcp/tables-records-and-exports).
