Read an agent session by its ID from an agent-session mention or search result. Returns the latest 20 messages in chronological order, including prompts, replies, tool activity and errors. Optionally select a turn number to inspect earlier history. Each message is capped at 4000 characters; truncated flags identify omitted history or text. Requires view access to the session.
The agent session UUID from its mention or search result.
turn
integer
No
Read only this turn number, as returned in messages; omit for recent history.
⌘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":"#ff8f05","light":"#ff8f05","dark":"#ff8f05"},"logo":{"light":"https://mintcdn.com/macro-a2d84caa/sYcZCyXGSkKkhq6m/logo/light.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=7f0d7fc38976ee6c70ad69fd85b3ea74","dark":"https://mintcdn.com/macro-a2d84caa/sYcZCyXGSkKkhq6m/logo/dark.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=83ba9bff3c2c74fb5fba8189f53f955a"},"favicon":{"light":"https://mintcdn.com/macro-a2d84caa/TbohKtAUdQfmVsR2/favicon.svg?fit=max\u0026auto=format\u0026n=TbohKtAUdQfmVsR2\u0026q=85\u0026s=497a9ea592764acefc22fc12432daf87","dark":"https://mintcdn.com/macro-a2d84caa/TbohKtAUdQfmVsR2/favicon.svg?fit=max\u0026auto=format\u0026n=TbohKtAUdQfmVsR2\u0026q=85\u0026s=497a9ea592764acefc22fc12432daf87"},"appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#090909"}},"navbar":{"primary":{"type":"button","label":"Get Macro","href":"https://macro.com"}},"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":""},"chroma":{"liveDeploymentHistoryId":"6ad7b582424ba1dc0f43e51b","collectionId":"4f06ae73-b6ba-479d-8cf2-40db718df8e2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7b582424ba1dc0f43e51b"},"entitlements":{},"buildId":"6ad7b582424ba1dc0f43e51b","clientVersion":"0.0.3902","searchFilterCounts":[{"language":"default","tag":"Agents","count":155},{"language":"default","tag":"Tool Reference","count":152},{"language":"default","tag":"Blocks","count":11},{"language":"default","tag":"Changelog","count":7},{"language":"default","tag":"2026","count":5},{"language":"default","tag":"Key Concepts","count":4},{"language":"default","tag":"Features","count":4},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"2025","count":1},{"language":"default","tag":"Releases","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","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":"editor-private-page-search","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":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"AI/mcp/tools/read-agent-session","slug":"/AI/mcp/tools/read-agent-session","pageMetadata":{"title":"ReadAgentSession","description":"Read an agent session by its ID from an agent-session mention or search result.","href":"/AI/mcp/tools/read-agent-session"},"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 an agent session by its ID from an agent-session mention or search result.\"\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:`readagentsession`,children:`ReadAgentSession`}),`\n`,_jsx(_components.p,{children:`Read an agent session by its ID from an agent-session mention or search result. Returns the latest 20 messages in chronological order, including prompts, replies, tool activity and errors. Optionally select a turn number to inspect earlier history. Each message is capped at 4000 characters; truncated flags identify omitted history or text. Requires view access to the session.`}),`\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:`sessionId`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The agent session UUID from its mention or search result.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`turn`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Read only this turn number, as returned in messages; omit for recent history.`})]})]})]})]})}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":"ReadAgentSession","description":"Read an agent session by its ID from an agent-session mention or search result.","href":"/AI/mcp/tools/read-agent-session"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"ReadAgentSession","slug":"readagentsession","depth":1,"children":[]},{"title":"Parameters","slug":"parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"macro-a2d84caa","siteName":"Macro","title":"ReadAgentSession - Macro","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T18:40:14.110Z","originalFileLocation":"AI/mcp/tools/read-agent-session.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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 an agent session by its ID from an agent-session mention or search result.\">\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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_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/oeN8zboryNCxE-Vd/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"ReadAgentSession - Macro\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read an agent session by its ID from an agent-session mention or search result.\">\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-agent-session\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"ReadAgentSession - Macro\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read an agent session by its ID from an agent-session mention or search result.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/macro-a2d84caa/oeN8zboryNCxE-Vd/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Macro\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#ff8f05\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.macro.com/AI/mcp/tools/read-agent-session\">\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-agent-session.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/sYcZCyXGSkKkhq6m/logo/light.svg?fit=max\u0026auto=format\u0026n=sYcZCyXGSkKkhq6m\u0026q=85\u0026s=7f0d7fc38976ee6c70ad69fd85b3ea74\"}},{\"@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-agent-session#webpage\",\"url\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session\",\"name\":\"ReadAgentSession\",\"description\":\"Read an agent session by its ID from an agent-session mention or search result.\",\"dateModified\":\"2026-10-20T18:40:14.110Z\",\"isPartOf\":{\"@id\":\"https://docs.macro.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Agents\",\"item\":\"https://docs.macro.com/AI/recipes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tool Reference\",\"item\":\"https://docs.macro.com/AI/mcp/tools/index\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ReadAgentSession\",\"item\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session#article\",\"headline\":\"ReadAgentSession\",\"name\":\"ReadAgentSession\",\"description\":\"Read an agent session by its ID from an agent-session mention or search result.\",\"url\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session\",\"mainEntityOfPage\":{\"@id\":\"https://docs.macro.com/AI/mcp/tools/read-agent-session#webpage\"},\"dateModified\":\"2026-10-20T18:40:14.110Z\",\"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\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Macro","nav":{"global":null,"pages":[{"title":"Welcome to Macro","icon":"house","href":"/index"},{"title":"Get 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 Inbox","icon":"inbox","href":"/product/inbox"},{"title":"Unified Search","icon":"magnifying-glass","href":"/product/search"},{"title":"Unified Memory","icon":"brain","href":"/product/unified-memory"},{"title":"Unified Tagging","icon":"tags","href":"/product/tagging"}]},{"group":"Blocks","pages":[{"title":"Agents","icon":"wand-magic-sparkles","href":"/product/agents"},{"title":"Email","icon":"envelope","href":"/product/email"},{"title":"Documents","icon":"file-lines","href":"/product/docs"},{"title":"Canvas","icon":"diagram-project","href":"/product/canvas"},{"title":"Tasks","icon":"list-check","href":"/product/tasks"},{"title":"Snippets","icon":"brackets-curly","href":"/product/snippets"},{"title":"Channels","icon":"hashtag","href":"/product/channels"},{"title":"Calls","icon":"phone","href":"/product/calls"},{"title":"Calendar","icon":"calendar","href":"/product/calendar"},{"title":"Folders","icon":"folder","href":"/product/folders"},{"title":"CRM","icon":"building","href":"/product/crm"}]},{"group":"Key Concepts","pages":[{"title":"Blocks","icon":"cubes","href":"/concepts/blocks"},{"title":"Mentions","icon":"at","href":"/concepts/mentions"},{"title":"Properties","icon":"tags","href":"/concepts/properties"},{"title":"Permissions","icon":"lock","href":"/permissions"}]},{"group":"Agents","pages":[{"title":"Agent recipes","icon":"book-open","href":"/AI/recipes"},{"title":"Bring your own agent","sidebarTitle":"Bring your own agent","icon":"terminal","tag":"Coming soon","href":"/AI/bring-your-own"},{"title":"MCP Setup","icon":"plug","href":"/AI/mcp/overview"},{"group":"Tool Reference","icon":"wrench","pages":[{"title":"Tool Reference","href":"/AI/mcp/tools/index"},{"title":"AddToPipeline","href":"/AI/mcp/tools/add-to-pipeline"},{"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":"CommentOnDocument","href":"/AI/mcp/tools/comment-on-document"},{"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":"DeleteDatabaseView","href":"/AI/mcp/tools/delete-database-view"},{"title":"DeleteDocumentComment","href":"/AI/mcp/tools/delete-document-comment"},{"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":"EditChannelMessage","href":"/AI/mcp/tools/edit-channel-message"},{"title":"EditDocument","href":"/AI/mcp/tools/edit-document"},{"title":"EditDocumentComment","href":"/AI/mcp/tools/edit-document-comment"},{"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":"ImportCompaniesCsv","href":"/AI/mcp/tools/import-companies-csv"},{"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":"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","description":"Read actions attributed to the authenticated user within a time range, newest first.","href":"/AI/mcp/tools/read-activity"},{"title":"ReadAgentSession","href":"/AI/mcp/tools/read-agent-session"},{"title":"ReadAgentSessionSharing","description":"Read an agent session's current owner, link sharing, team access, and channel grants.","href":"/AI/mcp/tools/read-agent-session-sharing"},{"title":"ReadBookingSettings","href":"/AI/mcp/tools/read-booking-settings"},{"title":"ReadCallRecord","href":"/AI/mcp/tools/read-call-record"},{"title":"ReadChannelMessageContext","href":"/AI/mcp/tools/read-channel-message-context"},{"title":"ReadChannelMessages","href":"/AI/mcp/tools/read-channel-messages"},{"title":"ReadChannelThread","href":"/AI/mcp/tools/read-channel-thread"},{"title":"ReadContent","href":"/AI/mcp/tools/read-content"},{"title":"ReadDesign","href":"/AI/mcp/tools/read-design"},{"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":"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":"ResolveDocumentComment","href":"/AI/mcp/tools/resolve-document-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":"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"}]}]}]},"title":"ReadAgentSession - Macro","buildId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","deploymentId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","dynamics":[],"chunks":[]}
