Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.
Help your team repeat work without starting from scratch. Skills and Custom Agents are resources you can share across your Notion workspace: a Skill gives your AI assistant instructions to follow, while a Custom Agent can take on work you delegate.Use a shared Skill to prepare a project update in your team’s format, or hand the task to a Custom Agent and review its results. Teammates with access can reuse the same instructions and agents in their own work.
Find our team’s project update Skill in Notion. Follow its instructions to draft this week’s update using our project notes, and show me the draft for review.
Find our reporting Custom Agent in Notion and ask it to prepare this week’s project update. Share the project context from our conversation, then bring back the agent’s draft for me to review.
Sharing a Skill or Custom Agent does not make it available to everyone automatically; teammates need access to use it. Enabling a Skill changes your own settings, not your teammates’ settings. Converting a page into a Skill keeps its instructions unchanged; uploading a Skill replaces the target page’s content. Working with Custom Agents requires Notion AI access and access to Custom Agents.
See the technical reference for parameters, response formats, requirements, and examples for these tools.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Notion Docs","colors":{"primary":"#000","light":"#097fe8","dark":"#0075de"},"logo":{"light":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d","dark":"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/dark.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=a8404879d171debac543bb6c1482c909","href":"/"},"favicon":"https://mintcdn.com/notion-demo/LHm9qfrJYJOPRxs6/favicon.png?fit=max\u0026auto=format\u0026n=LHm9qfrJYJOPRxs6\u0026q=85\u0026s=0668f0b3334eef21f0cdc65b390d22d9","api":{"openapi":["openapi.json","openapi-undocumented.json","openapi-adminApi.json"]},"appearance":{"default":"system"},"background":{"color":{"light":"#ffffff","dark":"#0f0f0f"}},"navbar":{"links":[{"href":"https://www.notion.com/login","label":"Log in"}],"primary":{"type":"button","label":"Developer portal","href":"https://www.notion.so/developers"}},"footer":{"socials":{"x":"https://x.com/NotionDevs","slack":"https://join.slack.com/t/notiondevs/shared_invite/zt-3u9oid9q8-HLUBmMVWYK~g9HFo4U4raA"}},"seo":{"metatags":{"og:image":"/images/og-image.png"}},"fonts":{"family":"NotionInter"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notion-demo","hasAudioNarration":false,"actualSubdomain":"notion-demo","customDomains":["developers.notion.com"],"gitSource":{"type":"github","owner":"makenotion","repo":"notion-next","deployBranch":"main","contentDirectory":"src/server-publicApiDocs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8a592b4392014d5244545","collectionId":"5c58e766-a4a5-4f3b-af76-377c9fa4f1bf","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8a592b4392014d5244545"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae8c884aa0de63df87d3597","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"API Reference","count":139},{"language":"default","tag":"Endpoints","count":121},{"language":"default","tag":"Guides","count":66},{"language":"default","tag":"Admin API","count":48},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Agents","count":22},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Data APIs","count":17},{"language":"default","tag":"Pages","count":17},{"language":"default","tag":"Get started","count":15}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"NotionInter\";font-weight:400;font-style:normal;font-display:optional;src:url(/fonts/NotionInter-Regular.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:normal;font-display:optional;src:url(/fonts/NotionInter-Medium.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:normal;font-display:optional;src:url(/fonts/NotionInter-SemiBold.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:normal;font-display:optional;src:url(/fonts/NotionInter-Bold.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:400;font-style:italic;font-display:optional;src:url(/fonts/NotionInter-Italic.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:500;font-style:italic;font-display:optional;src:url(/fonts/NotionInter-MediumItalic.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:600;font-style:italic;font-display:optional;src:url(/fonts/NotionInter-SemiBoldItalic.woff2) format(\"woff2\")}@font-face{font-family:\"NotionInter\";font-weight:700;font-style:italic;font-display:optional;src:url(/fonts/NotionInter-BoldItalic.woff2) format(\"woff2\")}:root{--font-notion-stack:\"NotionInter\", \"Inter\", -apple-system, \"system-ui\", \"Segoe UI\", Helvetica,\n\t\tArial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"}body,button,h1,h2,h3,h4,h5,h6,html,input,select,textarea{font-family:var(--font-notion-stack)}.card>.flex.items-center:has([data-component-part=card-icon]){align-items:flex-start}[data-component-part=card-content]{font-size:.875rem;line-height:1.45}.navbar-link>a{background-color:transparent!important}.bg-primary-dark.rounded-xl{border-radius:8px!important}#search-bar-entry,.navbar-link>a:hover,button[data-component-part=theme-preference-menu-trigger]{background-color:#37352f0a!important}#search-bar-entry:hover,button[data-component-part=theme-preference-menu-trigger]:hover,button[data-component-part=theme-preference-menu-trigger][aria-expanded=true]{background-color:#37352f1a!important}#search-bar-entry,#search-bar-entry svg,button[data-component-part=theme-preference-menu-trigger] svg{color:#7d7a75!important}#search-bar-entry:hover svg,button[data-component-part=theme-preference-menu-trigger]:hover svg,button[data-component-part=theme-preference-menu-trigger][aria-expanded=true] svg{color:#37352f!important}html.dark #search-bar-entry,html.dark .navbar-link>a:hover,html.dark button[data-component-part=theme-preference-menu-trigger]{background-color:rgba(255,255,255,.055)!important}html.dark #search-bar-entry:hover,html.dark button[data-component-part=theme-preference-menu-trigger]:hover,html.dark button[data-component-part=theme-preference-menu-trigger][aria-expanded=true]{background-color:rgba(255,255,255,.129)!important}html.dark #search-bar-entry,html.dark #search-bar-entry svg,html.dark button[data-component-part=theme-preference-menu-trigger] svg{color:rgba(255,255,255,.5)!important}html.dark #search-bar-entry:hover svg,html.dark button[data-component-part=theme-preference-menu-trigger]:hover svg,html.dark button[data-component-part=theme-preference-menu-trigger][aria-expanded=true] svg{color:#fff!important}#search-bar-entry-mobile,#search-bar-entry-mobile svg{color:#7d7a75!important;background-color:#7d7a75!important}#search-bar-entry-mobile:hover,#search-bar-entry-mobile:hover svg{color:#37352f!important;background-color:#37352f!important}html.dark #search-bar-entry-mobile,html.dark #search-bar-entry-mobile svg{color:rgba(255,255,255,.5)!important;background-color:rgba(255,255,255,.5)!important}html.dark #search-bar-entry-mobile:hover,html.dark #search-bar-entry-mobile:hover svg{color:#fff!important;background-color:#fff!important}#navbar [class*=border-gray-100],#sidebar-content[class*=border-gray-100],.card[class*=border-gray-950]{border-color:#e6e5e3!important}html.dark #navbar [class*=border-gray-800],html.dark #sidebar-content[class*=border-white],html.dark .card[class*=border-white]{border-color:rgba(255,255,255,.094)!important}.nav-tabs-item div[class*=bg-gray-200],.sidebar-nav-group-divider{background-color:#e6e5e3!important}html.dark .nav-tabs-item div[class*=bg-gray-700]{background-color:rgba(255,255,255,.18)!important}html.dark .sidebar-nav-group-divider{background-color:rgba(255,255,255,.094)!important}html:not(.dark) :is(a, button)[class*=outline-offset][class*=\"hover:text-gray-900\"]:hover,html:not(.dark) :is(a, button)[class*=outline-offset][class*=text-gray-700]{color:#37352f!important}html:not(.dark) :is(a, button)[class*=outline-offset] svg[class*=text-gray-400][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}html:not(.dark) :is(a, button)[class*=outline-offset]:hover svg[class*=text-gray-400][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a, button)[class*=outline-offset] svg[class*=text-gray-400][class*=\"group-hover:text-gray-600\"]{color:#7d7a75!important}html.dark :is(a, button)[class*=outline-offset]:hover svg[class*=text-gray-400][class*=\"group-hover:text-gray-600\"]{color:#ada9a3!important}[data-component-part=card-title]{color:#37352f!important}html.dark [data-component-part=card-title]{color:#fff!important}[data-component-part=card-content]{color:#7d7a75!important}html.dark [data-component-part=card-content]{color:#ada9a3!important}:is(a, button)[class*=outline-offset][class*=rounded-xl]{border-radius:6px!important}a[class*=text-shadow]{text-shadow:none!important;font-weight:600!important}.sidebar-group :is(a, button, span){hyphens:none!important}html.dark :is(a, button)[class*=outline-offset][class*=text-primary-light]{color:#fff!important}html.dark :is(a, button)[class*=outline-offset][class*=bg-primary-light]{background-color:rgba(255,255,255,.129)!important}:is(a, button)[class*=outline-offset][class*=\"bg-primary/10\"]{background-color:#37352f1a!important}:is(a, button)[class*=outline-offset][class*=\"hover:bg-gray-600\"]:hover{background-color:#37352f0a!important}html.dark :is(a, button)[class*=outline-offset][class*=\"hover:bg-gray-200\"]:hover{background-color:rgba(255,255,255,.055)!important}html.dark #table-of-contents-content li[data-active],html.dark #table-of-contents-content li[data-active]>a{border-color:#fff!important}html.dark #table-of-contents-content li[data-active]>a,html.dark a.nav-tabs-item[class*=text-primary],html.dark h1#page-title{color:#fff!important}html.dark a.nav-tabs-item div[class*=bg-primary-light]{background-color:#fff!important}.eyebrow,.sidebar-group-header{color:#78736f!important}html.dark .eyebrow{color:#a3a39e!important}html:is(\n\t[data-current-path=\"/page/changelog\"],\n\t[data-current-path=\"/page/examples\"]\n) #sidebar-content{display:none!important}html:is(\n\t[data-current-path=\"/page/changelog\"],\n\t[data-current-path=\"/page/examples\"]\n) #content-container{max-width:none!important;margin-left:0!important}html:is(\n\t[data-current-path=\"/page/changelog\"],\n\t[data-current-path=\"/page/examples\"]\n) #content-area{margin-left:0!important;margin-right:0!important}html[data-current-path=\"/page/changelog\"] [data-component-part=update-content]{font-size:1rem}html.dark .sidebar-group-header{color:#a3a39e!important}html.dark [class*=prose-invert]{color:#c7c7c7!important;--tw-prose-invert-body:#c7c7c7!important;--tw-prose-invert-bullets:#c7c7c7!important;--tw-prose-invert-counters:#c7c7c7!important}html.dark #header p,html.dark #table-of-contents-content a{color:#c7c7c7!important}html.dark .sidebar-group a:not([class*=text-shadow]),html.dark .sidebar-group button{color:#c7c7c7!important}html.dark #table-of-contents-content a:hover,html.dark .sidebar-group a:not([class*=text-shadow]):hover,html.dark .sidebar-group button:hover,html.dark a.nav-tabs-item:hover{color:#fff!important}#content a.link{text-decoration:underline!important;text-decoration-color:rgba(55,53,47,.25)!important;text-underline-offset:3px!important;text-decoration-thickness:1px!important;font-weight:inherit!important}#content a.link,#content a.link:hover{color:inherit!important}html.dark #content a.link{text-decoration-color:rgba(255,255,255,.25)!important}#content a.link:hover,html.dark #content a.link:hover{text-decoration-color:currentColor!important}.callout[class*=bg-blue]{background-color:#e5f2fc!important;border-color:#b6d4f3!important}.callout[class*=bg-blue] [data-component-part=callout-icon],.callout[class*=bg-blue] [data-component-part=callout-icon] svg{color:#2783de!important}.callout[class*=bg-blue] [data-component-part=callout-content]{color:#355f8b!important}.callout[class*=bg-green]{background-color:#e8f1ec!important;border-color:#bed9c9!important}.callout[class*=bg-green] [data-component-part=callout-icon],.callout[class*=bg-green] [data-component-part=callout-icon] svg{color:#46a171!important}.callout[class*=bg-green] [data-component-part=callout-content]{color:#37674c!important}.callout[class*=bg-yellow]{background-color:#f9f3dc!important;border-color:#e8d497!important}.callout[class*=bg-yellow] [data-component-part=callout-icon],.callout[class*=bg-yellow] [data-component-part=callout-icon] svg{color:#d8a32f!important}.callout[class*=bg-yellow] [data-component-part=callout-content]{color:#836426!important}.callout[class*=bg-red]{background-color:#fce9e7!important;border-color:#f0c5be!important}.callout[class*=bg-red] [data-component-part=callout-icon],.callout[class*=bg-red] [data-component-part=callout-icon] svg{color:#e56458!important}.callout[class*=bg-red] [data-component-part=callout-content]{color:#924943!important}.callout[class*=bg-neutral]{background-color:#f0efed!important;border-color:#e6e5e3!important}.callout[class*=bg-neutral] [data-component-part=callout-icon],.callout[class*=bg-neutral] [data-component-part=callout-icon] svg{color:#5f5e59!important}.callout[class*=bg-neutral] [data-component-part=callout-content]{color:#494846!important}html.dark .callout[class*=bg-blue]{background-color:rgba(39,131,222,.12)!important;border-color:rgba(39,131,222,.3)!important}html.dark .callout[class*=bg-green]{background-color:rgba(70,161,113,.12)!important;border-color:rgba(70,161,113,.3)!important}html.dark .callout[class*=bg-yellow]{background-color:rgba(216,163,47,.12)!important;border-color:rgba(216,163,47,.3)!important}html.dark .callout[class*=bg-red]{background-color:rgba(229,100,88,.12)!important;border-color:rgba(229,100,88,.3)!important}html.dark .callout[class*=bg-neutral]{background-color:rgba(255,255,255,.05)!important;border-color:rgba(255,255,255,.12)!important}html.dark .callout[class*=bg-blue] [data-component-part=callout-content]{color:#9dc0ea!important}html.dark .callout[class*=bg-green] [data-component-part=callout-content]{color:#a6c7b4!important}html.dark .callout[class*=bg-yellow] [data-component-part=callout-content]{color:#e2ca88!important}html.dark .callout[class*=bg-red] [data-component-part=callout-content]{color:#e0aea6!important}html.dark .callout[class*=bg-neutral] [data-component-part=callout-content]{color:#bcbab6!important}html.dark .callout[class*=bg-neutral] [data-component-part=callout-icon],html.dark .callout[class*=bg-neutral] [data-component-part=callout-icon] svg{color:#ada9a3!important}#content .callout a.link,#content a.link,.callout a.link{border-bottom:0!important}#content .callout a.link,#content .callout a.link:hover,.callout a.link,.callout a.link:hover{color:inherit!important;text-decoration:underline!important}[data-component-part=card-icon] img{filter:brightness(0) saturate(100%) invert(31%) sepia(85%) saturate(2280%) hue-rotate(196deg) brightness(96%) contrast(101%)}html.dark [data-component-part=card-icon] img{filter:brightness(0) saturate(100%) invert(45%) sepia(98%) saturate(1480%) hue-rotate(196deg) brightness(101%) contrast(96%)}[data-component-part=card-icon]>svg{width:1.25rem!important;height:1.25rem!important;mask-size:contain!important;-webkit-mask-size:contain!important}.card{transition:box-shadow 180ms ease-out,border-color 180ms ease-out}.card:hover,html.dark .card:hover{--tw-ring-shadow:0 0 #0000!important;--tw-ring-color:transparent!important}.card:hover{border-color:transparent!important;box-shadow:0 0 0 1px rgba(0,0,0,.06),0 4px 10px rgba(15,15,15,.05),0 1px 3px rgba(15,15,15,.04)!important}html.dark .card:hover{border-color:rgba(255,255,255,.18)!important;box-shadow:none!important}a[class*=\"border-gray-200/70\"][class*=rounded-xl][class*=py-3][class*=px-4]{border:0!important;padding:0!important}[data-component-part=code-block-root],[data-component-part=code-block-root] code,[data-component-part=code-block-root] code *,[data-component-part=code-block-root] pre{font-size:12px!important;line-height:20px!important}#page-context-menu [class*=rounded-l-xl]{border-radius:6px 0 0 6px!important}#page-context-menu [class*=rounded-r-xl]{border-radius:0 6px 6px 0!important}#page-context-menu [class*=text-sm]{font-size:12px!important}#page-context-menu :is(button, a)[class*=bg-gray],#page-context-menu :is(button, a)[class*=border-gray]{background-color:transparent!important;border-color:#e6e5e3!important}#page-context-menu :is(button, a):hover{background-color:#37352f0a!important}html.dark #page-context-menu :is(button, a)[class*=bg-gray],html.dark #page-context-menu :is(button, a)[class*=border-gray]{border-color:rgba(255,255,255,.094)!important}html.dark #page-context-menu :is(button, a):hover{background-color:rgba(255,255,255,.055)!important}[data-component-part=update-label]{background-color:#f7f6f3!important;color:#5f5e59!important;font-size:14px!important;line-height:20px!important;font-weight:400!important}html.dark [data-component-part=update-label]{background-color:rgba(255,255,255,.04)!important;color:#bcbab6!important}[class*=text-tooltip-foreground]{background-color:#1f1f1d!important;color:#fff!important;border-color:#1f1f1d!important}"}],"page":{"pagePath":"guides/mcp/tools-skills-agents","slug":"/guides/mcp/tools-skills-agents","pageMetadata":{"title":"Reuse instructions and delegate work","description":"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.","og:title":"Use shared Skills and delegate to Notion Custom Agents","keywords":["shared Skills","reusable instructions","delegate work","Custom Agents","agent sessions"],"href":"/guides/mcp/tools-skills-agents"},"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: \"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\"\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={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,Prompt,Tab,Table,Tabs}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Prompt)_missingMdxReference(`Prompt`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Help your team repeat work without starting from scratch. Skills and Custom Agents are resources you can share across your Notion workspace: a Skill gives your AI assistant instructions to follow, while a Custom Agent can take on work you delegate.`}),`\n`,_jsx(_components.p,{children:`Use a shared Skill to prepare a project update in your team’s format, or hand the task to a Custom Agent and review its results. Teammates with access can reuse the same instructions and agents in their own work.`}),`\n`,_jsx(Heading,{level:`2`,id:`try-a-prompt`,children:`Try a prompt`}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`Use a shared Skill`,id:`use-a-shared-skill`,children:_jsx(Prompt,{description:`Find our team’s project update Skill in Notion. Follow its instructions to draft this week’s update using our project notes, and show me the draft for review.`,actions:[`copy`],children:`Find our team’s project update Skill in Notion. Follow its instructions to draft this week’s update using our project notes, and show me the draft for review.\n`})}),_jsx(Tab,{title:`Delegate to a Custom Agent`,id:`delegate-to-a-custom-agent`,children:_jsx(Prompt,{description:`Find our reporting Custom Agent in Notion and ask it to prepare this week’s project update. Share the project context from our conversation, then bring back the agent’s draft for me to review.`,actions:[`copy`],children:`Find our reporting Custom Agent in Notion and ask it to prepare this week’s project update. Share the project context from our conversation, then bring back the agent’s draft for me to review.\n`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`available-tools`,children:`Available tools`}),`\n`,_jsx(`span`,{id:`convert-a-page-to-a-skill`}),`\n`,_jsx(`span`,{id:`download-a-notion-skill`}),`\n`,_jsx(`span`,{id:`upload-a-notion-skill`}),`\n`,_jsx(`span`,{id:`manage-enabled-skills`}),`\n`,_jsx(`span`,{id:`search-personal-memories`}),`\n`,_jsx(`span`,{id:`work-with-custom-agent-sessions`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Tool name`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create a Skill from a page`}),_jsx(_components.td,{children:`Turn an existing instructions page into a Notion Skill.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#convert-a-page-to-a-skill`,children:_jsx(_components.code,{children:`notion-convert-page-to-skill`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Download a Skill`}),_jsx(_components.td,{children:`Export a Skill and its supporting files.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#download-a-notion-skill`,children:_jsx(_components.code,{children:`notion-download-skill`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Upload a Skill`}),_jsx(_components.td,{children:`Import a Skill into a page in a Skills database.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#upload-a-notion-skill`,children:_jsx(_components.code,{children:`notion-upload-skill`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Choose your Skills`}),_jsx(_components.td,{children:`See enabled Skills and enable or disable them.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#manage-enabled-skills`,children:_jsx(_components.code,{children:`notion-get-enabled-skills`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#manage-enabled-skills`,children:_jsx(_components.code,{children:`notion-update-enabled-skills`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Find saved context`}),_jsx(_components.td,{children:`Search preferences and decisions saved by your connected agents.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#search-personal-memories`,children:_jsx(_components.code,{children:`notion-memory-search`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Find Custom Agents`}),_jsx(_components.td,{children:`Find an agent shared with you that can take on a task.`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-search-agents`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Find agent conversations`}),_jsx(_components.td,{children:`Browse or search existing sessions.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-query-sessions`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-search-sessions`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Delegate or follow up`}),_jsx(_components.td,{children:`Hand a task to a Custom Agent or send a follow-up message.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-spawn-session`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-send-message-to-session`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Check or stop work`}),_jsx(_components.td,{children:`Check progress, wait for a response, or stop a run.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-get-session-status`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-wait-session`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-stop-session`})})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Read session activity`}),_jsx(_components.td,{children:`List and read events from an agent session.`}),_jsxs(_components.td,{children:[_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-list-session-events`})}),` `,_jsx(`br`,{}),` `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#work-with-custom-agent-sessions`,children:_jsx(_components.code,{children:`notion-read-session-event`})})]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`things-to-know`,children:`Things to know`}),`\n`,_jsx(_components.p,{children:`Sharing a Skill or Custom Agent does not make it available to everyone automatically; teammates need access to use it. Enabling a Skill changes your own settings, not your teammates’ settings. Converting a page into a Skill keeps its instructions unchanged; uploading a Skill replaces the target page’s content. Working with Custom Agents requires Notion AI access and access to Custom Agents.`}),`\n`,_jsx(Heading,{level:`2`,id:`technical-reference`,children:`Technical reference`}),`\n`,_jsxs(_components.p,{children:[`See the `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference`,children:`technical reference`}),` for parameters, response formats, requirements, and examples for these tools.`]})]})}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":"Reuse instructions and delegate work","description":"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.","og:title":"Use shared Skills and delegate to Notion Custom Agents","keywords":["shared Skills","reusable instructions","delegate work","Custom Agents","agent sessions"],"href":"/guides/mcp/tools-skills-agents"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Try a prompt","slug":"try-a-prompt","depth":2,"children":[]},{"title":"Available tools","slug":"available-tools","depth":2,"children":[]},{"title":"Things to know","slug":"things-to-know","depth":2,"children":[]},{"title":"Technical reference","slug":"technical-reference","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/notion-demo/84dcfd2aef2479f3/mcp-section-label.js","/_mintlify/custom/notion-demo/96b92b5a9cb7e11c/mcp-tool-section-redirects.js"],"subdomain":"notion-demo","siteName":"Notion Docs","title":"Use shared Skills and delegate to Notion Custom Agents","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T15:01:14.789Z","originalFileLocation":"guides/mcp/tools-skills-agents.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Use shared Skills and delegate to Notion Custom Agents\">\u003cmeta data-mint-head property=\"og:description\" content=\"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notion Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.notion.com/guides/mcp/tools-skills-agents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://notion-demo.mintlify.app/images/og-image.png\">\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=\"Use shared Skills and delegate to Notion Custom Agents\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notion-demo.mintlify.app/images/og-image.png\">\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/notion-demo/1PaJq9z3waub4TpE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notion Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.notion.com/guides/mcp/tools-skills-agents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/mcp/tools-skills-agents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.notion.com/#organization\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/notion-demo/5YdhSbldE14t5Rna/logo/light.svg?fit=max\u0026auto=format\u0026n=5YdhSbldE14t5Rna\u0026q=85\u0026s=249f5693ad929397409bf9b51d6d539d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.notion.com#website\",\"name\":\"Notion Docs\",\"url\":\"https://developers.notion.com\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.notion.com/guides/mcp/tools-skills-agents#webpage\",\"url\":\"https://developers.notion.com/guides/mcp/tools-skills-agents\",\"name\":\"Reuse instructions and delegate work\",\"description\":\"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\",\"dateModified\":\"2026-11-02T15:01:14.789Z\",\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.notion.com/guides/mcp/tools-skills-agents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.notion.com/guides/mcp/tools-skills-agents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Notion MCP\",\"item\":\"https://developers.notion.com/guides/mcp/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Supported tools\",\"item\":\"https://developers.notion.com/guides/mcp/mcp-supported-tools\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Reuse instructions and delegate work\",\"item\":\"https://developers.notion.com/guides/mcp/tools-skills-agents\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://developers.notion.com/guides/mcp/tools-skills-agents#article\",\"headline\":\"Reuse instructions and delegate work\",\"name\":\"Reuse instructions and delegate work\",\"description\":\"Use shared Skills to repeat tasks with your AI assistant, or delegate work to Custom Agents your team can access in Notion.\",\"url\":\"https://developers.notion.com/guides/mcp/tools-skills-agents\",\"mainEntityOfPage\":{\"@id\":\"https://developers.notion.com/guides/mcp/tools-skills-agents#webpage\"},\"image\":\"https://developers.notion.com/images/og-image.png\",\"dateModified\":\"2026-11-02T15:01:14.789Z\",\"keywords\":\"shared Skills, reusable instructions, delegate work, Custom Agents, agent sessions\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","siteName":"Notion Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Notion connections","sidebarTitle":"Overview","href":"/guides/get-started/overview"},{"title":"API quickstart","sidebarTitle":"Quickstart","href":"/guides/get-started/quick-start"},{"title":"Developer tools","href":"/guides/get-started/developer-tools"},{"title":"Personal access tokens","href":"/guides/get-started/personal-access-tokens"},{"title":"Internal connections","href":"/guides/get-started/internal-connections"},{"title":"Public connections","href":"/guides/get-started/public-connections"},{"title":"Authorization","href":"/guides/get-started/authorization"},{"title":"Secure API credentials","sidebarTitle":"API credential security","href":"/guides/get-started/handling-api-keys"},{"title":"Preparing your connection for users","sidebarTitle":"Preparing for users","href":"/guides/get-started/preparing-for-users"},{"title":"List on the Marketplace","href":"/guides/get-started/marketplace-listing"}]},{"group":"Notion MCP","pages":[{"title":"Overview","sidebarTitle":"Overview","href":"/guides/mcp/overview"},{"group":"Connect to Notion MCP","root":{"title":"Connect to Notion MCP","href":"/guides/mcp/get-started-with-mcp"},"pages":[{"title":"Build an MCP client for Notion","href":"/guides/mcp/build-mcp-client"}]},{"group":"Supported tools","root":{"title":"Supported tools","href":"/guides/mcp/mcp-supported-tools"},"pages":[{"group":"Search and read information","root":{"title":"Search and read information","href":"/guides/mcp/tools-search"},"pages":[{"title":"Search and read information — technical reference","sidebarTitle":"Technical reference","href":"/guides/mcp/tools-search-reference"}]},{"group":"Work together in Notion","root":{"title":"Work together in Notion","href":"/guides/mcp/tools-comments"},"pages":[{"title":"Work together in Notion — technical reference","sidebarTitle":"Technical reference","href":"/guides/mcp/tools-comments-reference"}]},{"group":"Create and organize pages","root":{"title":"Create and organize pages","href":"/guides/mcp/tools-pages"},"pages":[{"title":"Create and organize pages — technical reference","sidebarTitle":"Technical reference","href":"/guides/mcp/tools-pages-reference"}]},{"group":"Manage databases and views","root":{"title":"Manage databases and views","href":"/guides/mcp/tools-databases"},"pages":[{"title":"Manage databases and views — technical reference","sidebarTitle":"Technical reference","href":"/guides/mcp/tools-databases-reference"}]},{"group":"Work with files","root":{"title":"Work with files","href":"/guides/mcp/tools-files"},"pages":[{"title":"Work with files — technical reference","sidebarTitle":"Technical reference","description":"Find upload steps, file-size limits, attachment options, and download-link requirements for Notion MCP file tools.","href":"/guides/mcp/tools-files-reference"}]},{"group":"Reuse instructions and delegate work","root":{"title":"Reuse instructions and delegate work","href":"/guides/mcp/tools-skills-agents"},"pages":[{"title":"Reuse instructions and delegate work — technical reference","sidebarTitle":"Technical reference","description":"Find parameters for importing and enabling Notion Skills, searching memories, and starting and managing Custom Agent sessions.","href":"/guides/mcp/tools-skills-agents-reference"}]},{"group":"Manage your time","root":{"title":"Manage your time","href":"/guides/mcp/tools-calendars"},"pages":[{"title":"Manage your time — technical reference","sidebarTitle":"Technical reference","href":"/guides/mcp/tools-calendars-reference"}]},{"title":"Notion MCP tool FAQs","sidebarTitle":"FAQs and troubleshooting","href":"/guides/mcp/tools-faqs"},{"title":"Notion MCP rate limits","sidebarTitle":"Rate limits","href":"/guides/mcp/rate-limits"}]},{"title":"Use Notion Skills with MCP","sidebarTitle":"Skills via MCP","href":"/guides/mcp/notion-skills"},{"title":"Enterprise-managed authorization","sidebarTitle":"Enterprise-managed authorization","href":"/guides/mcp/enterprise-managed-authorization"},{"title":"Security best practices","href":"/guides/mcp/mcp-security-best-practices"}]},{"group":"Agent APIs","pages":[{"group":"Notion Agent APIs","pages":[{"title":"Overview","href":"/guides/notion-agent-apis/overview"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/guides/notion-agent-apis/quickstart"},{"title":"Upgrading to public beta","href":"/guides/notion-agent-apis/upgrading-to-public-beta"}]},{"group":"Agent Skills API","pages":[{"title":"Agent Skills API","sidebarTitle":"Overview","href":"/guides/agent-skills/overview"}]}]},{"group":"API versions","pages":[{"group":"Upgrading to 2026-03-11","pages":[{"title":"Upgrade guide","sidebarTitle":"Upgrade guide","href":"/guides/get-started/upgrade-guide-2026-03-11"}]},{"group":"Upgrading to 2025-09-03","pages":[{"title":"Upgrade guide","sidebarTitle":"Upgrade guide","href":"/guides/get-started/upgrade-guide-2025-09-03"},{"title":"FAQs","href":"/guides/get-started/upgrade-faqs-2025-09-03"}]}]},{"group":"Data APIs","pages":[{"title":"Working with page content","href":"/guides/data-apis/working-with-page-content"},{"title":"Read every item in a page property","sidebarTitle":"Read page properties","href":"/guides/data-apis/read-page-property-values"},{"group":"Working with databases","pages":[{"title":"Working with databases","sidebarTitle":"Overview","href":"/guides/data-apis/working-with-databases"},{"title":"Create a page in a data source","sidebarTitle":"Create a page","href":"/guides/data-apis/create-pages-in-a-data-source"},{"title":"Query large data sources","sidebarTitle":"Large data sources","href":"/guides/data-apis/query-large-data-sources"},{"title":"Creating pages from templates","href":"/guides/data-apis/creating-pages-from-templates"}]},{"title":"Working with views","href":"/guides/data-apis/working-with-views"},{"title":"Working with comments","href":"/guides/data-apis/working-with-comments"},{"group":"Working with markdown content","pages":[{"title":"Working with markdown content","href":"/guides/data-apis/working-with-markdown-content"},{"title":"Migrate to Notion-flavored Markdown (v2)","sidebarTitle":"Migrate to v2","href":"/guides/data-apis/migrate-to-notion-flavored-markdown"},{"title":"Enhanced markdown format (v1, deprecated)","href":"/guides/data-apis/enhanced-markdown"},{"title":"Notion-flavored Markdown format","href":"/guides/data-apis/notion-flavored-markdown"}]},{"group":"Working with files and media","pages":[{"title":"Working with files and media","sidebarTitle":"Overview","href":"/guides/data-apis/working-with-files-and-media"},{"title":"Uploading small files","href":"/guides/data-apis/uploading-small-files"},{"title":"Retrieving existing files","href":"/guides/data-apis/retrieving-files"},{"title":"Uploading larger files","href":"/guides/data-apis/sending-larger-files"},{"title":"Importing external files","href":"/guides/data-apis/importing-external-files"}]}]},{"group":"Manage connections","pages":[{"title":"Connection health","href":"/guides/manage-connections/connection-health"}]},{"group":"Resources","pages":[{"title":"Example code","url":"https://developers.notion.com/page/examples","href":"/guides/resources/examples"},{"title":"Postman workspace","url":"https://www.postman.com/notionhq/notion-s-api-workspace/collection/52041987-03f70d8f-b6e5-4306-805c-f95f7cdf05b9","href":"/guides/resources/notion-s-api-workspace"},{"title":"Historical changelog","href":"/guides/resources/historical-changelog"}]},{"group":"Compliance","pages":[{"title":"Overview","href":"/compliance/overview"},{"group":"Event reference","pages":[{"title":"SIEM events","href":"/compliance/siem-events"},{"title":"Audit log events","href":"/compliance/audit-log-events"}]}]},{"group":"Link previews","pages":[{"title":"Introduction","href":"/guides/link-previews/introduction"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/intro"}]},{"tab":"CLI Reference","pages":[{"title":"CLI Reference","href":"/cli/get-started/overview"}]},{"tab":"Workers","pages":[{"title":"Workers","href":"/workers/get-started/overview"}]},{"tab":"Custom blocks","hidden":true,"pages":[{"title":"Custom blocks","href":"/custom-blocks/overview"}]},{"tab":"Admin API","hidden":false,"pages":[{"title":"Admin API","href":"/reference/admin/intro"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/page/changelog"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/page/examples"}]},{"tab":"Prompts","hidden":true,"searchable":true,"pages":[{"title":"Prompts","href":"/prompts/setup"}]},{"tab":"Internal","hidden":true,"pages":[{"title":"Internal","href":"/guides/internal/link-previews/building-a-link-preview"}]},{"tab":"Unreleased APIs","hidden":true,"pages":[{"title":"Unreleased APIs","href":"/reference/unreleased/external-agent-apis/start-external-agent-session"}]}]},"basePath":"","title":"Use shared Skills and delegate to Notion Custom Agents","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["869c33ed97"],"chunks":["Prompt-Ch3v3ib2.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js"]}