Read Documents
read_docsFetch monday.com document content with markdown or view version history. Retrieve block details, comments, and content diffs with pagination support.
Instructions
Get information about monday.com documents. Supports two modes:
MODE: "content" (default) — Fetch documents with their full markdown content.
Requires: type ("ids" | "object_ids" | "workspace_ids") and ids array
Supports pagination via page/limit. Check has_more_pages in response.
If type "ids" returns no results, automatically retries with object_ids.
Set include_blocks: true to include block IDs, types, and positions in the response — required before calling update_doc.
Blocks default to 25 per page. Use blocks_limit and blocks_page to paginate through long documents.
Set include_comments: true to fetch all comments and replies on the document. Each comment is enriched with anchor info (block_id, selection_from, selection_length) indicating which block and text range it's attached to. Use comments_limit to control how many comments per item (default 50).
MODE: "version_history" — Fetch the edit history of a single document.
Requires: ids with the document's object_id (use the object_id field from content mode results, NOT the id field).
The object_id is the numeric ID visible in the document URL.
Returns restoring points sorted newest-first. Use version_history_limit to cap results (e.g., "last 3 changes" → version_history_limit: 3).
Use since/until to filter by time range. If omitted, returns full history.
Set include_diff: true to see what content changed between versions (fetches up to 10 diffs, may be slower).
Examples:
{ mode: "version_history", ids: ["5001466606"], version_history_limit: 3 }
{ mode: "version_history", ids: ["5001466606"], since: "2026-03-11T00:00:00Z", include_diff: true }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | The operation mode. "content" (default) fetches documents with their markdown content. "version_history" fetches the edit history of a single document. | content |
| type | No | Query type for content mode: "ids", "object_ids", or "workspace_ids". Required when mode is "content". | |
| ids | No | Array of ID values. In content mode: matches the query type (ids/object_ids/workspace_ids). In version_history mode: provide the single document object_id here (e.g., ids: ["5001466606"]). | |
| limit | No | Number of docs per page (default: 25). Only used in content mode. | |
| order_by | No | Order in which to retrieve docs. Only used in content mode. | |
| page | No | Page number to return (starts at 1). Only used in content mode. | |
| include_blocks | No | If true, includes the blocks array (block IDs, types, positions, content) in the response. Required when you plan to call update_doc. Defaults to false to reduce response size. Only used in content mode. | |
| blocks_limit | No | Maximum number of blocks to return per document (default: 25). Only used in content mode when include_blocks is true. | |
| blocks_page | No | Page number for block pagination, starting at 1. Omit to use the API default. Use with blocks_limit to page through documents with more than 25 blocks. Only used in content mode when include_blocks is true. | |
| include_comments | No | If true, fetches all comments and replies on the document. Comments are stored at the item level within the doc backing board. Defaults to false. Only used in content mode. | |
| comments_limit | No | Maximum number of comments (updates) to fetch per item when include_comments is true. Defaults to 50. Only used in content mode. | |
| version_history_limit | No | Maximum number of restoring points to return. Use this when the user asks for "last N changes". Only used in version_history mode. | |
| since | No | ISO 8601 date string to filter version history from (e.g., "2026-03-15T00:00:00Z"). If omitted, returns the full history. Only used in version_history mode. | |
| until | No | ISO 8601 date string to filter version history until (e.g., "2026-03-16T23:59:59Z"). Defaults to now. Only used in version_history mode. | |
| include_diff | No | If true, fetches content diffs between consecutive restoring points. May be slower due to additional API calls. Only used in version_history mode. |