> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Tables

> Lists all tables in Google BigQuery datasets with metadata information

Lists all tables in Google BigQuery datasets with metadata information

|                      |                        |
| -------------------- | ---------------------- |
| **App**              | BigQuery               |
| **Operation ID**     | `bigquery_list_tables` |
| **Type**             | Action                 |
| **Connection**       | `bigquery` (required)  |
| **Credits per run**  | 1                      |
| **Agent / MCP tool** | Yes                    |

## Inputs

| Field     | Type                 | Required | Default | Description                                                                                                                                  |
| --------- | -------------------- | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `project` | string or SelectItem | Yes      | -       | Select the Google BigQuery project, ask the user for it if not provided                                                                      |
| `dataset` | string or SelectItem | No       | -       | Select the BigQuery dataset containing your target table, ask the user for it if not provided. Leave empty to list tables from all datasets. |
| `limit`   | integer              | No       | `1000`  | The maximum number of tables to return                                                                                                       |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `List[Dict]`

Returns list of tables.

**Fields**: `table_id`, `full_table_id`, `dataset_id`, `table_type`