Read a small structured window of top-level messages from a channel. Use this for latest messages, bounded time ranges, cursor continuation, or a window around a message. For full thread replies, use ReadChannelThread.
Inclusive lower bound for activity timestamps. Required when windowType is timeRange.
to
string
No
Exclusive upper bound for activity timestamps. Required when windowType is timeRange.
messageId
string
No
Anchor message id. Required when windowType is aroundMessage.
cursor
string
No
Opaque cursor returned by this tool. Required when windowType is page.
direction
"older" | "newer"
No
Direction to read from the cursor. Required when windowType is page.
messageIds
string[]
No
Top-level message ids to read. Required when windowType is messages.
limit
integer
No
Maximum number of top-level messages to return. Defaults to 25, maximum 100.
includeThreadPreviews
boolean
No
Whether to include thread preview replies on returned top-level messages. Defaults to true.
maxCharsPerMessage
integer
No
Maximum characters to return per message/reply. Defaults to 4000, maximum 16000.
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Macro","description":"Product and technical documentation for Macro, the unified interface for email, messages, tasks, calls, agents, pull requests, docs, CRM — linked together with shared AI memory.","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/light.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=4f2be14c1f50d4339ee013aeeb1b11e9","dark":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/dark.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=70107b68de1fa8c26acfac75dbdd9e01"},"favicon":"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/favicon.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=f8c739e97fea6c138b93df62734ee836","appearance":{"default":"system","strict":true},"background":{"color":{"light":"#f5f1e8","dark":"#000000"}},"navbar":{"primary":{"type":"button","label":"Get Macro","href":"https://macro.com"}},"fonts":{"heading":{"family":"Roboto Slab","source":"fonts/roboto-slab-variable.woff2","format":"woff2"},"body":{"family":"Inter","source":"fonts/inter-variable.woff2","format":"woff2"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"macro-a2d84caa","hasAudioNarration":false,"actualSubdomain":"macro-a2d84caa","customDomains":["docs.macro.com"],"gitSource":{"type":"github","owner":"macro-inc","repo":"macro","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6af2844f6a135f921056ded6","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Agents","count":172},{"language":"default","tag":"Tool Reference","count":167},{"language":"default","tag":"Blocks","count":15},{"language":"default","tag":"Changelog","count":7},{"language":"default","tag":"2026","count":5},{"language":"default","tag":"Drive","count":5},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"Key Concepts","count":3},{"language":"default","tag":"2025","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/macro-a2d84caa/148e0bc7475dbc96/style.css"}],"page":{"pagePath":"AI/mcp/tools/read-channel-messages","slug":"/AI/mcp/tools/read-channel-messages","pageMetadata":{"title":"ReadChannelMessages","description":"Read a small structured window of top-level messages from a channel.","href":"/AI/mcp/tools/read-channel-messages"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Read a small structured window of top-level messages from a channel.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`1`,id:`readchannelmessages`,children:`ReadChannelMessages`}),`\n`,_jsx(_components.p,{children:`Read a small structured window of top-level messages from a channel. Use this for latest messages, bounded time ranges, cursor continuation, or a window around a message. For full thread replies, use ReadChannelThread.`}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Parameter`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`channelId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Channel id to read.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`windowType`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"latest\"`}),` | `,_jsx(_components.code,{children:`\"timeRange\"`}),` | `,_jsx(_components.code,{children:`\"aroundMessage\"`}),` | `,_jsx(_components.code,{children:`\"page\"`}),` | `,_jsx(_components.code,{children:`\"messages\"`})]}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Type of channel timeline window to read.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`from`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Inclusive lower bound for activity timestamps. Required when windowType is timeRange.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`to`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Exclusive upper bound for activity timestamps. Required when windowType is timeRange.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messageId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Anchor message id. Required when windowType is aroundMessage.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cursor`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Opaque cursor returned by this tool. Required when windowType is page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`direction`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`\"older\"`}),` | `,_jsx(_components.code,{children:`\"newer\"`})]}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Direction to read from the cursor. Required when windowType is page.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`messageIds`})}),_jsx(_components.td,{children:`string[]`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Top-level message ids to read. Required when windowType is messages.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`limit`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Maximum number of top-level messages to return. Defaults to 25, maximum 100.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`includeThreadPreviews`})}),_jsx(_components.td,{children:`boolean`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Whether to include thread preview replies on returned top-level messages. Defaults to true.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`maxCharsPerMessage`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Maximum characters to return per message/reply. Defaults to 4000, maximum 16000.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"ReadChannelMessages","description":"Read a small structured window of top-level messages from a channel.","href":"/AI/mcp/tools/read-channel-messages"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"ReadChannelMessages","slug":"readchannelmessages","depth":1,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"macro-a2d84caa","siteName":"Macro","title":"ReadChannelMessages - Macro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-02T22:33:27.718Z","originalFileLocation":"AI/mcp/tools/read-channel-messages.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"system\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Read a small structured window of top-level messages from a channel.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Macro\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ReadChannelMessages - Macro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read a small structured window of top-level messages from a channel.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Macro\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.macro.com/AI/mcp/tools/read-channel-messages\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://macro-a2d84caa.mintlify.site/_mintlify/api/og/v2?division=Tool+Reference\u0026amp;title=ReadChannelMessages\u0026amp;description=Read+a+small+structured+window+of+top-level+messages+from+a+channel.\u0026amp;theme=713e4eb693be6243d2db78e0\u0026amp;signature=8c7f6143a67cd4ceadb9bb6a3da01be8f2df4c74c1974b7a4d8e7181d9bac8fa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ReadChannelMessages - Macro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read a small structured window of top-level messages from a channel.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://macro-a2d84caa.mintlify.site/_mintlify/api/og/v2?division=Tool+Reference\u0026amp;title=ReadChannelMessages\u0026amp;description=Read+a+small+structured+window+of+top-level+messages+from+a+channel.\u0026amp;theme=713e4eb693be6243d2db78e0\u0026amp;signature=8c7f6143a67cd4ceadb9bb6a3da01be8f2df4c74c1974b7a4d8e7181d9bac8fa\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/RngrnyM0xCQFDfCn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Macro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.macro.com/AI/mcp/tools/read-channel-messages\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/AI/mcp/tools/read-channel-messages.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.macro.com/#organization\",\"name\":\"Macro\",\"url\":\"https://docs.macro.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/macro-a2d84caa/hHOXgcdCjBAaCcmP/logo/light.svg?fit=max\u0026auto=format\u0026n=hHOXgcdCjBAaCcmP\u0026q=85\u0026s=4f2be14c1f50d4339ee013aeeb1b11e9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.macro.com#website\",\"name\":\"Macro\",\"url\":\"https://docs.macro.com\",\"publisher\":{\"@id\":\"https://docs.macro.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages#webpage\",\"url\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages\",\"name\":\"ReadChannelMessages\",\"description\":\"Read a small structured window of top-level messages from a channel.\",\"dateModified\":\"2026-10-02T22:33:27.718Z\",\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.macro.com/AI/bring-your-own\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tool Reference\",\"item\":\"https://docs.macro.com/AI/mcp/tools\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ReadChannelMessages\",\"item\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages#article\",\"headline\":\"ReadChannelMessages\",\"name\":\"ReadChannelMessages\",\"description\":\"Read a small structured window of top-level messages from a channel.\",\"url\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages\",\"mainEntityOfPage\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-channel-messages#webpage\"},\"dateModified\":\"2026-10-02T22:33:27.718Z\",\"publisher\":{\"@id\":\"https://docs.macro.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Macro\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Macro\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/AI/mcp/tools/read-channel-messages.md","siteName":"Macro","nav":{"global":null,"pages":[{"title":"Welcome to Macro","icon":"house","href":"/index"},{"title":"Getting started","icon":"rocket","href":"/getting-started"},{"title":"Switch to Macro","icon":"arrow-right-arrow-left","href":"/switch-to-macro"},{"title":"Get the App","icon":"display","href":"/apps"},{"group":"Features","pages":[{"title":"Unified Search","icon":"magnifying-glass","href":"/product/search"},{"title":"Unified Memory","icon":"brain","href":"/product/unified-memory"},{"title":"Unified Tagging","icon":"tag","href":"/product/tagging"},{"title":"Unified Sharing","icon":"share","href":"/product/sharing"}]},{"group":"Blocks","pages":[{"title":"Home","icon":"house","href":"/product/home"},{"group":"Drive","icon":"folder","root":{"title":"Drive","icon":"folder","href":"/product/drive"},"pages":[{"title":"Documents","icon":"file","href":"/product/docs"},{"title":"Spreadsheets","icon":"table","href":"/product/spreadsheets"},{"title":"Canvas","icon":"shapes","href":"/product/canvas"},{"title":"Snippets","icon":"brackets-curly","href":"/product/snippets"},{"title":"Databases","icon":"database","href":"/product/databases"}]},{"title":"Email","icon":"envelope","href":"/product/email"},{"title":"Chat","icon":"comment","href":"/product/channels"},{"group":"Tasks","icon":"square-check","root":{"title":"Tasks","icon":"square-check","href":"/product/tasks"},"pages":[{"title":"Projects","icon":"layer-group","href":"/product/projects"}]},{"group":"Calendar","icon":"calendar","root":{"title":"Calendar","icon":"calendar","href":"/product/calendar"},"pages":[{"title":"Booking links","icon":"calendar-check","href":"/product/booking-links"}]},{"group":"Agents","icon":"sparkle","root":{"title":"Agents","icon":"sparkle","href":"/product/agents"},"pages":[{"title":"Routines","icon":"clock","href":"/product/routines"},{"title":"Skills","icon":"pen-ruler","href":"/product/skills"}]},{"title":"Customers","icon":"buildings","href":"/product/crm"},{"title":"Calls","icon":"phone-volume","href":"/product/calls"},{"title":"Reviews","icon":"code-pull-request","href":"/product/reviews"}]},{"group":"Key Concepts","pages":[{"title":"Mentions","icon":"at","href":"/concepts/mentions"},{"title":"Properties","icon":"tags","href":"/concepts/properties"},{"title":"Permissions","icon":"lock","href":"/permissions"}]},{"group":"Agents","pages":[{"title":"Bring your own agent","sidebarTitle":"Bring your own agent","icon":"terminal","href":"/AI/bring-your-own"},{"title":"Cursor","sidebarTitle":"Cursor","icon":"code","href":"/AI/cursor"},{"title":"MCP Setup","icon":"plug","href":"/AI/mcp/overview"},{"group":"Tool Reference","icon":"wrench","pages":[{"title":"Tool Reference","href":"/AI/mcp/tools/index"},{"title":"AddSharedCalendarEvent","href":"/AI/mcp/tools/add-shared-calendar-event"},{"title":"AddToPipeline","href":"/AI/mcp/tools/add-to-pipeline"},{"title":"ApplyCanvasEdits","href":"/AI/mcp/tools/apply-canvas-edits"},{"title":"BashCodeExecution","href":"/AI/mcp/tools/bash-code-execution"},{"title":"BulkSetEntityPropertyOptions","href":"/AI/mcp/tools/bulk-set-entity-property-options"},{"title":"CalculateSpreadsheet","href":"/AI/mcp/tools/calculate-spreadsheet"},{"title":"ChangeBooking","href":"/AI/mcp/tools/change-booking"},{"title":"Comment","href":"/AI/mcp/tools/comment"},{"title":"CommentOnText","href":"/AI/mcp/tools/comment-on-text"},{"title":"ConfigureAgent","href":"/AI/mcp/tools/configure-agent"},{"title":"ConfigureBot","href":"/AI/mcp/tools/configure-bot"},{"title":"ContentSearch","href":"/AI/mcp/tools/content-search"},{"title":"CreateAgentSession","href":"/AI/mcp/tools/create-agent-session"},{"title":"CreateBookingLink","href":"/AI/mcp/tools/create-booking-link"},{"title":"CreateBot","href":"/AI/mcp/tools/create-bot"},{"title":"CreateCalendarEvent","href":"/AI/mcp/tools/create-calendar-event"},{"title":"CreateChannel","href":"/AI/mcp/tools/create-channel"},{"title":"CreateChannelMediaUpload","href":"/AI/mcp/tools/create-channel-media-upload"},{"title":"CreateCompany","href":"/AI/mcp/tools/create-company"},{"title":"CreateContact","href":"/AI/mcp/tools/create-contact"},{"title":"CreateDocument","href":"/AI/mcp/tools/create-document"},{"title":"CreateForm","href":"/AI/mcp/tools/create-form"},{"title":"CreateImportEntity","href":"/AI/mcp/tools/create-import-entity"},{"title":"CreateInitiative","href":"/AI/mcp/tools/create-initiative"},{"title":"CreatePipeline","href":"/AI/mcp/tools/create-pipeline"},{"title":"CreateProject","href":"/AI/mcp/tools/create-project"},{"title":"CreateRoutine","href":"/AI/mcp/tools/create-routine"},{"title":"CreateSkill","href":"/AI/mcp/tools/create-skill"},{"title":"CreateTag","href":"/AI/mcp/tools/create-tag"},{"title":"Decide","href":"/AI/mcp/tools/decide"},{"title":"DeleteBot","href":"/AI/mcp/tools/delete-bot"},{"title":"DeleteCalendarEvent","href":"/AI/mcp/tools/delete-calendar-event"},{"title":"DeleteCallRecord","href":"/AI/mcp/tools/delete-call-record"},{"title":"DeleteChannelMessage","href":"/AI/mcp/tools/delete-channel-message"},{"title":"DeleteComment","href":"/AI/mcp/tools/delete-comment"},{"title":"DeleteDatabaseView","href":"/AI/mcp/tools/delete-database-view"},{"title":"DeleteImportEntity","href":"/AI/mcp/tools/delete-import-entity"},{"title":"DeleteInitiative","href":"/AI/mcp/tools/delete-initiative"},{"title":"DeleteRoutine","href":"/AI/mcp/tools/delete-routine"},{"title":"DeleteTag","href":"/AI/mcp/tools/delete-tag"},{"title":"DescribeDatabase","href":"/AI/mcp/tools/describe-database"},{"title":"DispatchCodingAgent","href":"/AI/mcp/tools/dispatch-coding-agent"},{"title":"DuplicateItem","href":"/AI/mcp/tools/duplicate-item"},{"title":"EditBookingLink","href":"/AI/mcp/tools/edit-booking-link"},{"title":"EditCanvas","href":"/AI/mcp/tools/edit-canvas"},{"title":"EditChannelMessage","href":"/AI/mcp/tools/edit-channel-message"},{"title":"EditComment","href":"/AI/mcp/tools/edit-comment"},{"title":"EditDocument","href":"/AI/mcp/tools/edit-document"},{"title":"EditForm","href":"/AI/mcp/tools/edit-form"},{"title":"EditPipeline","href":"/AI/mcp/tools/edit-pipeline"},{"title":"EditPresentation","href":"/AI/mcp/tools/edit-presentation"},{"title":"EditSpreadsheet","href":"/AI/mcp/tools/edit-spreadsheet"},{"title":"EditTag","href":"/AI/mcp/tools/edit-tag"},{"title":"EditWordDocument","href":"/AI/mcp/tools/edit-word-document"},{"title":"ExportPipelineCsv","href":"/AI/mcp/tools/export-pipeline-csv"},{"title":"FindPipelineEntries","href":"/AI/mcp/tools/find-pipeline-entries"},{"title":"GenerateImage","href":"/AI/mcp/tools/generate-image"},{"title":"GenerateObject","href":"/AI/mcp/tools/generate-object"},{"title":"GetBookingInsights","href":"/AI/mcp/tools/get-booking-insights"},{"title":"GetBookingRescheduleSlots","href":"/AI/mcp/tools/get-booking-reschedule-slots"},{"title":"GetBotWebhooks","href":"/AI/mcp/tools/get-bot-webhooks"},{"title":"GetCompany","href":"/AI/mcp/tools/get-company"},{"title":"GetEntityProperties","href":"/AI/mcp/tools/get-entity-properties"},{"title":"GetTeamAvailability","href":"/AI/mcp/tools/get-team-availability"},{"title":"GetThread","href":"/AI/mcp/tools/get-thread"},{"title":"GetUserActivity","href":"/AI/mcp/tools/get-user-activity"},{"title":"ImportCompaniesCsv","href":"/AI/mcp/tools/import-companies-csv"},{"title":"ImportFromJira","href":"/AI/mcp/tools/import-from-jira"},{"title":"ImportFromLinear","href":"/AI/mcp/tools/import-from-linear"},{"title":"ImportFromNotion","href":"/AI/mcp/tools/import-from-notion"},{"title":"ImportNotionPage","href":"/AI/mcp/tools/import-notion-page"},{"title":"ImportPipelineCsv","href":"/AI/mcp/tools/import-pipeline-csv"},{"title":"IssueBotCredential","href":"/AI/mcp/tools/issue-bot-credential"},{"title":"ListAgents","href":"/AI/mcp/tools/list-agents"},{"title":"ListAgentUpdates","href":"/AI/mcp/tools/list-agent-updates"},{"title":"ListBookingLinks","href":"/AI/mcp/tools/list-booking-links"},{"title":"ListBookings","href":"/AI/mcp/tools/list-bookings"},{"title":"ListBots","href":"/AI/mcp/tools/list-bots"},{"title":"ListCalendarEvents","href":"/AI/mcp/tools/list-calendar-events"},{"title":"ListCalendars","href":"/AI/mcp/tools/list-calendars"},{"title":"ListCodingAgents","href":"/AI/mcp/tools/list-coding-agents"},{"title":"ListCompanies","href":"/AI/mcp/tools/list-companies"},{"title":"ListDatabases","href":"/AI/mcp/tools/list-databases"},{"title":"ListEntities","href":"/AI/mcp/tools/list-entities"},{"title":"ListForms","href":"/AI/mcp/tools/list-forms"},{"title":"ListImportEntities","href":"/AI/mcp/tools/list-import-entities"},{"title":"ListInboxes","href":"/AI/mcp/tools/list-inboxes"},{"title":"ListInitiatives","href":"/AI/mcp/tools/list-initiatives"},{"title":"ListLabels","href":"/AI/mcp/tools/list-labels"},{"title":"ListNotifications","href":"/AI/mcp/tools/list-notifications"},{"title":"ListPipelines","href":"/AI/mcp/tools/list-pipelines"},{"title":"ListRoutines","href":"/AI/mcp/tools/list-routines"},{"title":"ListSkills","href":"/AI/mcp/tools/list-skills"},{"title":"ListTags","href":"/AI/mcp/tools/list-tags"},{"title":"ListTeamMembers","href":"/AI/mcp/tools/list-team-members"},{"title":"ManageAgentSession","href":"/AI/mcp/tools/manage-agent-session"},{"title":"ManageBotChannelAccess","href":"/AI/mcp/tools/manage-bot-channel-access"},{"title":"ManageChannelParticipants","href":"/AI/mcp/tools/manage-channel-participants"},{"title":"MarkNotificationsDone","href":"/AI/mcp/tools/mark-notifications-done"},{"title":"MarkNotificationsSeen","href":"/AI/mcp/tools/mark-notifications-seen"},{"title":"MoveToProject","href":"/AI/mcp/tools/move-to-project"},{"title":"MoveToTrash","href":"/AI/mcp/tools/move-to-trash"},{"title":"MuteNotifications","href":"/AI/mcp/tools/mute-notifications"},{"title":"NameSearch","href":"/AI/mcp/tools/name-search"},{"title":"OpenDirectMessage","href":"/AI/mcp/tools/open-direct-message"},{"title":"QueryDatabase","href":"/AI/mcp/tools/query-database"},{"title":"ReactToChannelMessage","href":"/AI/mcp/tools/react-to-channel-message"},{"title":"ReadActivity","href":"/AI/mcp/tools/read-activity"},{"title":"ReadAgentSession","href":"/AI/mcp/tools/read-agent-session"},{"title":"ReadAgentSessionSharing","href":"/AI/mcp/tools/read-agent-session-sharing"},{"title":"ReadBookingSettings","href":"/AI/mcp/tools/read-booking-settings"},{"title":"ReadCalendarEvent","href":"/AI/mcp/tools/read-calendar-event"},{"title":"ReadCallRecord","href":"/AI/mcp/tools/read-call-record"},{"title":"ReadCanvas","href":"/AI/mcp/tools/read-canvas"},{"title":"ReadChannelMessageContext","description":"Read the local channel and thread context around one message id.","href":"/AI/mcp/tools/read-channel-message-context"},{"title":"ReadChannelMessages","href":"/AI/mcp/tools/read-channel-messages"},{"title":"ReadChannelThread","description":"Read replies from a channel message thread.","href":"/AI/mcp/tools/read-channel-thread"},{"title":"ReadContent","href":"/AI/mcp/tools/read-content"},{"title":"ReadDesign","href":"/AI/mcp/tools/read-design"},{"title":"ReadDiscussion","href":"/AI/mcp/tools/read-discussion"},{"title":"ReadForm","href":"/AI/mcp/tools/read-form"},{"title":"ReadIllustratorDocument","href":"/AI/mcp/tools/read-illustrator-document"},{"title":"ReadInitiative","href":"/AI/mcp/tools/read-initiative"},{"title":"ReadInitiativeActivity","href":"/AI/mcp/tools/read-initiative-activity"},{"title":"ReadMemory","href":"/AI/mcp/tools/read-memory"},{"title":"ReadMetadata","href":"/AI/mcp/tools/read-metadata"},{"title":"ReadPhotoshopDocument","href":"/AI/mcp/tools/read-photoshop-document"},{"title":"ReadPresentation","href":"/AI/mcp/tools/read-presentation"},{"title":"ReadProject","href":"/AI/mcp/tools/read-project"},{"title":"ReadRoutine","href":"/AI/mcp/tools/read-routine"},{"title":"ReadSkill","href":"/AI/mcp/tools/read-skill"},{"title":"ReadSpreadsheet","href":"/AI/mcp/tools/read-spreadsheet"},{"title":"ReadWordDocument","href":"/AI/mcp/tools/read-word-document"},{"title":"RemoveFromPipeline","href":"/AI/mcp/tools/remove-from-pipeline"},{"title":"RenameChannel","href":"/AI/mcp/tools/rename-channel"},{"title":"RenameDocument","href":"/AI/mcp/tools/rename-document"},{"title":"RenameItem","href":"/AI/mcp/tools/rename-item"},{"title":"RenderCanvas","href":"/AI/mcp/tools/render-canvas"},{"title":"ResolveComment","href":"/AI/mcp/tools/resolve-comment"},{"title":"RunRoutine","href":"/AI/mcp/tools/run-routine"},{"title":"SaveDatabaseQuery","href":"/AI/mcp/tools/save-database-query"},{"title":"SaveDatabaseView","href":"/AI/mcp/tools/save-database-view"},{"title":"SearchSkills","href":"/AI/mcp/tools/search-skills"},{"title":"SelfKnowledge","href":"/AI/mcp/tools/self-knowledge"},{"title":"SendChannelMessage","href":"/AI/mcp/tools/send-channel-message"},{"title":"SetEntityProperty","href":"/AI/mcp/tools/set-entity-property"},{"title":"SetFavorite","href":"/AI/mcp/tools/set-favorite"},{"title":"SetFormAccess","href":"/AI/mcp/tools/set-form-access"},{"title":"SetSenderPolicy","href":"/AI/mcp/tools/set-sender-policy"},{"title":"ShareWithChannel","href":"/AI/mcp/tools/share-with-channel"},{"title":"Subagent","href":"/AI/mcp/tools/subagent"},{"title":"TextEditorCodeExecution","href":"/AI/mcp/tools/text-editor-code-execution"},{"title":"UpdateAgentSessionSharing","href":"/AI/mcp/tools/update-agent-session-sharing"},{"title":"UpdateBookingSettings","href":"/AI/mcp/tools/update-booking-settings"},{"title":"UpdateCalendarEvent","href":"/AI/mcp/tools/update-calendar-event"},{"title":"UpdateCallRecord","href":"/AI/mcp/tools/update-call-record"},{"title":"UpdateInitiative","href":"/AI/mcp/tools/update-initiative"},{"title":"UpdateInitiativeSharing","href":"/AI/mcp/tools/update-initiative-sharing"},{"title":"UpdateMemory","href":"/AI/mcp/tools/update-memory"},{"title":"UpdatePipelineEntries","href":"/AI/mcp/tools/update-pipeline-entries"},{"title":"UpdateRoutine","href":"/AI/mcp/tools/update-routine"},{"title":"UpdateSharing","href":"/AI/mcp/tools/update-sharing"},{"title":"UpdateThreadLabels","href":"/AI/mcp/tools/update-thread-labels"},{"title":"UploadFile","href":"/AI/mcp/tools/upload-file"},{"title":"WebFetch","href":"/AI/mcp/tools/web-fetch"},{"title":"WebSearch","href":"/AI/mcp/tools/web-search"}]}]},{"group":"Integrations","pages":[{"title":"GitHub","icon":"github","href":"/integrations/github"}]},{"group":"Account","pages":[{"title":"Teams \u0026 Admin","icon":"users","href":"/account/teams"},{"title":"Billing \u0026 Plans","icon":"credit-card","href":"/account/billing"},{"title":"Security","icon":"shield-check","href":"/security"}]},{"title":"Get Support","icon":"headset","href":"/support"},{"title":"FAQ","icon":"circle-question","href":"/faq"},{"title":"Keyboard Shortcuts","icon":"keyboard","href":"/keyboard-shortcuts"},{"group":"Changelog","pages":[{"group":"Releases","pages":[{"title":"Changelog","icon":"clock-rotate-left","href":"/changelog/introduction"}]},{"group":"2026","pages":[{"title":"May 2026","href":"/changelog/2026-05"},{"title":"April 2026","href":"/changelog/2026-04"},{"title":"March 2026","href":"/changelog/2026-03"},{"title":"February 2026","href":"/changelog/2026-02"},{"title":"January 2026","href":"/changelog/2026-01"}]},{"group":"2025","pages":[{"title":"December 2025","href":"/changelog/2025-12"}]}]}]},"basePath":"","title":"ReadChannelMessages - Macro","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":[],"chunks":[]}