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.
Try a prompt
Use a shared Skill
Delegate to a Custom Agent
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.
Personal memories
Memories let your AI assistant save preferences, corrections, and decisions in Notion and recall them in later sessions. You can use them across clients connected to the same Notion account and workspace. Ask your assistant to remember the context you want to save; connecting MCP doesn’t automatically import another client’s chat history.Notion stores this context in a personal Memories database and an About page that summarizes it. Both are created when you save your first memory. You can read, edit, or remove this information in Notion. Memories are private to you. They don’t grant a client access to content you can’t already access, and they don’t replace current source information.Memory via MCP is available on all plans through user-backed connections, with memories enabled for both you and your workspace. It isn’t available through workspace-owned connections. See View your Notion Agent Memories for user controls and privacy details, or the memory tool reference for reading, saving, and updating memories.
Available tools
Action
What it does
Tool name
Create a Skill from a page
Turn an existing instructions page into a Notion Skill.
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.
Technical reference
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":""},"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":"6b0108b082f0182f6b575fdd","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":142},{"language":"default","tag":"Endpoints","count":135},{"language":"default","tag":"Guides","count":77},{"language":"default","tag":"Admin API","count":58},{"language":"default","tag":"Webhook events","count":31},{"language":"default","tag":"Notion API","count":23},{"language":"default","tag":"Notion MCP","count":23},{"language":"default","tag":"Agents","count":23},{"language":"default","tag":"Objects","count":18},{"language":"default","tag":"Data APIs","count":17}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","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:\n\t\t\"NotionInter\", \"Inter\", -apple-system, \"system-ui\", \"Segoe UI\", Helvetica,\n\t\tArial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"}html,body,button,input,select,textarea,h1,h2,h3,h4,h5,h6{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:0.875rem;line-height:1.45}.navbar-link>a{background-color:transparent!important}.navbar-link>a:hover{background-color:#37352f0a!important}html.dark .navbar-link>a:hover{background-color:rgba(255, 255, 255, 0.055)!important}.bg-primary-dark.rounded-xl{border-radius:8px!important}#search-bar-entry{background-color:#37352f0a!important;color:#7d7a75!important}#search-bar-entry:hover{background-color:#37352f1a!important}#search-bar-entry svg{color:#7d7a75!important}#search-bar-entry:hover svg{color:#37352f!important}html.dark #search-bar-entry{background-color:rgba(255, 255, 255, 0.055)!important;color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover{background-color:rgba(255, 255, 255, 0.129)!important}html.dark #search-bar-entry svg{color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry:hover svg{color:#ffffff!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, 0.5)!important;background-color:rgba(255, 255, 255, 0.5)!important}html.dark #search-bar-entry-mobile:hover,html.dark #search-bar-entry-mobile:hover svg{color:#ffffff!important;background-color:#ffffff!important}button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:#37352f0a!important}button[data-component-part=\"theme-preference-menu-trigger\"]:hover,button[data-component-part=\"theme-preference-menu-trigger\"][aria-expanded=\"true\"]{background-color:#37352f1a!important}html.dark button[data-component-part=\"theme-preference-menu-trigger\"]{background-color:rgba(255, 255, 255, 0.055)!important}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, 0.129)!important}button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:#7d7a75!important}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 button[data-component-part=\"theme-preference-menu-trigger\"] svg{color:rgba(255, 255, 255, 0.5)!important}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:#ffffff!important}#navbar [class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #navbar [class*=\"border-gray-800\"]{border-color:rgba(255, 255, 255, 0.094)!important}.nav-tabs-item div[class*=\"bg-gray-200\"]{background-color:#e6e5e3!important}html.dark .nav-tabs-item div[class*=\"bg-gray-700\"]{background-color:rgba(255, 255, 255, 0.18)!important}#sidebar-content[class*=\"border-gray-100\"]{border-color:#e6e5e3!important}html.dark #sidebar-content[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}.sidebar-nav-group-divider{background-color:#e6e5e3!important}html.dark .sidebar-nav-group-divider{background-color:rgba(255, 255, 255, 0.094)!important}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\"][class*=\"hover:text-gray-900\"]:hover{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}.card[class*=\"border-gray-950\"]{border-color:#e6e5e3!important}html.dark .card[class*=\"border-white\"]{border-color:rgba(255, 255, 255, 0.094)!important}[data-component-part=\"card-title\"]{color:#37352f!important}html.dark [data-component-part=\"card-title\"]{color:#ffffff!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:#ffffff!important}html.dark :is(a,button)[class*=\"outline-offset\"][class*=\"bg-primary-light\"]{background-color:rgba(255, 255, 255, 0.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, 0.055)!important}html.dark #table-of-contents-content li[data-active],html.dark #table-of-contents-content li[data-active]>a{border-color:#ffffff!important}html.dark #table-of-contents-content li[data-active]>a{color:#ffffff!important}html.dark a.nav-tabs-item[class*=\"text-primary\"]{color:#ffffff!important}html.dark a.nav-tabs-item div[class*=\"bg-primary-light\"]{background-color:#ffffff!important}.eyebrow{color:#78736f!important}html.dark .eyebrow{color:#a3a39e!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #sidebar-content{display:none!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-container{max-width:none!important;margin-left:0!important}html:is([data-current-path=\"/page/changelog\"],[data-current-path=\"/page/examples\"]) #content-area{margin-left:0!important;margin-right:0!important}html[data-current-path=\"/page/changelog\"] [data-component-part=\"update-content\"]{font-size:1rem}.sidebar-group-header{color:#78736f!important}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 h1#page-title{color:#ffffff!important}html.dark #header p{color:#c7c7c7!important}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:#ffffff!important}#content a.link{color:inherit!important;text-decoration:underline!important;text-decoration-color:rgba(55, 53, 47, 0.25)!important;text-underline-offset:3px!important;text-decoration-thickness:1px!important;border-bottom:0!important;font-weight:inherit!important}#content a.link:hover{color:inherit!important;text-decoration-color:currentColor!important}html.dark #content a.link{text-decoration-color:rgba(255, 255, 255, 0.25)!important}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, 0.12)!important;border-color:rgba(39, 131, 222, 0.3)!important}html.dark .callout[class*=\"bg-green\"]{background-color:rgba(70, 161, 113, 0.12)!important;border-color:rgba(70, 161, 113, 0.3)!important}html.dark .callout[class*=\"bg-yellow\"]{background-color:rgba(216, 163, 47, 0.12)!important;border-color:rgba(216, 163, 47, 0.3)!important}html.dark .callout[class*=\"bg-red\"]{background-color:rgba(229, 100, 88, 0.12)!important;border-color:rgba(229, 100, 88, 0.3)!important}html.dark .callout[class*=\"bg-neutral\"]{background-color:rgba(255, 255, 255, 0.05)!important;border-color:rgba(255, 255, 255, 0.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}.callout a.link,#content .callout a.link{color:inherit!important;text-decoration:underline!important;border-bottom:0!important}.callout a.link:hover,#content .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%)\n\t\thue-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%)\n\t\thue-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,\n\t\tborder-color 180ms ease-out}.card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:transparent!important;box-shadow:0 0 0 1px rgba(0, 0, 0, 0.06),\n\t\t0 4px 10px rgba(15, 15, 15, 0.05),\n\t\t0 1px 3px rgba(15, 15, 15, 0.04)!important}html.dark .card:hover{--tw-ring-shadow: 0 0 #0000 !important;--tw-ring-color: transparent !important;border-color:rgba(255, 255, 255, 0.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\"] pre,[data-component-part=\"code-block-root\"] code,[data-component-part=\"code-block-root\"] code *{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, 0.094)!important}html.dark #page-context-menu :is(button,a):hover{background-color:rgba(255, 255, 255, 0.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, 0.04)!important;color:#bcbab6!important}[class*=\"text-tooltip-foreground\"]{background-color:#1f1f1d!important;color:#ffffff!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","personal memories","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`,strong:`strong`,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:`personal-memories`,children:`Personal memories`}),`\n`,_jsx(_components.p,{children:`Memories let your AI assistant save preferences, corrections, and decisions in Notion and recall them in later sessions. You can use them across clients connected to the same Notion account and workspace. Ask your assistant to remember the context you want to save; connecting MCP doesn’t automatically import another client’s chat history.`}),`\n`,_jsxs(_components.p,{children:[`Notion stores this context in a personal `,_jsx(_components.strong,{children:`Memories`}),` database and an `,_jsx(_components.strong,{children:`About page`}),` that summarizes it. Both are created when you save your first memory. You can read, edit, or remove this information in Notion. Memories are private to you. They don’t grant a client access to content you can’t already access, and they don’t replace current source information.`]}),`\n`,_jsxs(_components.p,{children:[`Memory via MCP is available on all plans through user-backed connections, with memories enabled for both you and your workspace. It isn’t available through workspace-owned connections. See `,_jsx(_components.a,{href:`https://www.notion.com/help/view-your-notion-agent-memories`,children:`View your Notion Agent Memories`}),` for user controls and privacy details, or the `,_jsx(_components.a,{href:`/guides/mcp/tools-skills-agents-reference#search-personal-memories`,children:`memory tool reference`}),` for reading, saving, and updating memories.`]}),`\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 your private memories for 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","personal memories","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":"Personal memories","slug":"personal-memories","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/f3af24179eebc764/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-11T20:53:43.778Z","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.site/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.site/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-11T20:53:43.778Z\",\"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-11T20:53:43.778Z\",\"keywords\":\"shared Skills, reusable instructions, personal memories, delegate work, Custom Agents, agent sessions\",\"publisher\":{\"@id\":\"https://developers.notion.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.notion.com#website\"}}]}\u003c/script>","agentPointerHref":"/guides/mcp/tools-skills-agents.md","siteName":"Notion Docs","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Guides","groups":[{"group":"Notion API","pages":[{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/guides/notion-api/quick-start"},{"group":"Connections and tokens","root":{"title":"Connections and tokens","sidebarTitle":"Connections and tokens","href":"/guides/connections-and-tokens/overview"},"pages":[{"title":"Personal access tokens","href":"/guides/connections-and-tokens/personal-access-tokens"},{"title":"Internal connections","href":"/guides/connections-and-tokens/internal-connections"},{"group":"OAuth integrations","root":{"title":"OAuth integrations","href":"/guides/connections-and-tokens/oauth-integrations/overview"},"pages":[{"title":"Set up content for users","sidebarTitle":"Set up content for users","href":"/guides/connections-and-tokens/oauth-integrations/preparing-for-users"}]},{"group":"Public integrations","root":{"title":"Public integrations","href":"/guides/connections-and-tokens/public-integrations/overview"},"pages":[{"title":"List on the Marketplace","href":"/guides/connections-and-tokens/public-integrations/marketplace-listing"}]},{"title":"Share a connection","href":"/guides/connections-and-tokens/share-a-connection"}]},{"group":"Authorization","root":{"title":"Authorization","href":"/guides/authorization/overview"},"pages":[{"title":"Secure API credentials","sidebarTitle":"API credential security","href":"/guides/authorization/credential-security"}]},{"group":"Developer tools","root":{"title":"Developer tools","href":"/guides/developer-tools/overview"},"pages":[{"title":"Connection health","href":"/guides/developer-tools/connection-health"}]}]},{"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 from the alpha routes","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":"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","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["869c33ed97"],"chunks":["Prompt-BbXM_FJH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}