Search, read, create, and update Notion pages and databases.

OfficialMITAuto-check passedSales & Support

Install Notion

skills CLI
$ npx skills add aws-samples/sample-strands-agent-with-agentcore --skill notion -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install aws-samples/sample-strands-agent-with-agentcore notion --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/aws-samples/sample-strands-agent-with-agentcore.git skills-src && mkdir -p .claude/skills && cp -r skills-src/chatbot-app/agentcore/skills/notion .claude/skills/notion && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notion
GitHub stars
194
Token cost
~1.3k tokens
SKILL.md length
487 words
Files
6
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Search, read, create, and update Notion pages and databases.

  • Tasks that involve Sales call preparation
  • SKILL.md covers Available Tools, Markdown Support, Common Workflows and Use-Case Guides, plus 1 more section
  • Calls python

What it does

Notion is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization. Search, read, create, and update Notion pages and databases. Supports knowledge capture, meeting prep, research documentation, and spec-to-task workflows.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files (for example `block-types.md`, `knowledge-capture.md` and `meeting-intelligence.md`).

It sits in Sales & Support, covering Sales call preparation. It works with Notion. The repository describes itself as: Reference architecture for agentic AI chatbots with Strands Agents and Amazon Bedrock AgentCore. The licence is MIT.

When your agent uses it

  • Tasks that involve Sales call preparation

Example prompts

  • “/notion”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 6dd9d13. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notion loads about 1.3k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 487 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from aws-samples/sample-strands-agent-with-agentcore at commit 6dd9d13, republished under its MIT licence (© aws-samples). 487 words, ~1,347 tokens.

Download SKILL.mdSave it as .claude/skills/notion/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
notion
description
Search, read, create, and update Notion pages and databases. Supports knowledge capture, meeting prep, research documentation, and spec-to-task workflows.

Notion

Available Tools

  • notion_search(query?, filter_type?, page_size?): Search across all accessible pages and databases.

    • query (string, optional): Search text. Empty string returns all accessible pages.
    • filter_type (string, optional): "page" or "database". Use "database" to list databases.
    • page_size (integer, optional, default: 10, max: 100)
  • notion_fetch(page_id, include_block_ids?): Fetch a page's full content as readable markdown (metadata + all blocks in one call).

    • page_id (string, required): Page or database entry ID.
    • include_block_ids (boolean, optional, default: false): If true, appends each block's ID as <!-- id:... -->. Use this when you need to update a specific block with notion_update_block.
    • Returns: title, URL, last-edited time, and full body as markdown.
  • notion_create_page(parent_type, parent_id, title, properties_json?, content_markdown?): Create a new page.

    • parent_type (string, required): "database", "page", or "workspace" (workspace root)
    • parent_id (string, required): Parent UUID — ignored when parent_type="workspace"
    • title (string, required): Page title
    • properties_json (string, optional): Database properties as a JSON string — e.g., '{"Status": {"select": {"name": "In Progress"}}}'
    • content_markdown (string, optional): Initial body content as markdown (see Markdown Support below)
  • notion_update_page(page_id, properties_json, archived?): Update page properties (metadata/database fields only, not content blocks).

  • notion_update_block(block_id, content_markdown): Replace the content of a specific existing block.

    • block_id (string, required): Block ID — obtain via notion_fetch(include_block_ids=True)
    • content_markdown (string, required): New content as a single markdown line (only the first block is used)
    • page_id (string, required)
    • properties_json (string, required): Properties as a JSON string
    • archived (boolean, optional): true to archive, false to unarchive
  • notion_append_blocks(page_id, content_markdown): Append new content blocks to the end of an existing page.

    • page_id (string, required)
    • content_markdown (string, required): Markdown content to append (see Markdown Support below)

Markdown Support

Both notion_create_page (content_markdown) and notion_append_blocks support:

SyntaxBlock type
# Title / ## Heading / ### Subheading_1 / heading_2 / heading_3
- item or * itembulleted_list_item
1. itemnumbered_list_item
- [ ] taskto_do (unchecked)
- [x] taskto_do (checked)
```python\ncode\n```code block with language
> textquote
---divider
**bold**bold inline
*italic*italic inline
`code`inline code
Show full SKILL.md (188 more words)Show less

Common Workflows

Find and read a page:

1. notion_search(query="page name") → get page id
2. notion_fetch(page_id) → read full content

Create a new page with content:

notion_create_page(
  parent_type="page",
  parent_id="<parent-page-id>",
  title="My Page",
  content_markdown="## Overview\n\nContent here..."
)

Add content to existing page:

notion_append_blocks(
  page_id="<page-id>",
  content_markdown="## New Section\n\n- Point 1\n- Point 2"
)

Edit a specific block:

1. notion_fetch(page_id, include_block_ids=True)
   → ## Old Heading  <!-- id:abc-123 -->
2. notion_update_block(block_id="abc-123", content_markdown="## New Heading")

List databases:

notion_search(filter_type="database")

Use-Case Guides

For specific workflow patterns, load the reference files:

  • knowledge-capture.md — Save conversation insights, decisions, and how-to guides to Notion wikis and databases
  • meeting-intelligence.md — Prepare meeting materials by gathering Notion context and creating pre-reads and agendas
  • research-documentation.md — Research across Notion pages, synthesize findings, and write structured reports
  • spec-to-implementation.md — Turn spec pages into implementation plans, tasks, and progress tracking

Load a reference with: skill_dispatcher("notion", reference="knowledge-capture.md")

UI Guidance (from tools-config)

Notion Tool Usage:

  • notion_search: Search pages and databases. Use filter_type='database' to list databases.
  • notion_fetch: Read a page's full content as markdown (metadata + all blocks in one call).
  • notion_create_page: Create a new page with markdown content.
  • notion_update_page: Update page properties (not content — use notion_append_blocks for content).
  • notion_append_blocks: Add markdown content to an existing page.

Typical workflows:

  • Find and read: notion_search → notion_fetch
  • Create from scratch: notion_create_page with content_markdown
  • Update content: notion_append_blocks with markdown

Markdown support in content_markdown/notion_append_blocks:

  • Headings: # H1 / ## H2 / ### H3
  • Lists: - bullet / 1. numbered
  • To-do: - [ ] unchecked / - [x] checked
  • Code: python ...
  • Quote: > text
  • Divider: ---
  • Inline: bold, italic, code

© aws-samples, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files in chatbot-app/agentcore/skills/notion of aws-samples/sample-strands-agent-with-agentcore.

  • SKILL.md
  • block-types.md
  • knowledge-capture.md
  • meeting-intelligence.md
  • research-documentation.md
  • spec-to-implementation.md

Open the folder on GitHubat commit 6dd9d13

Compare with similar skills

Notion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notion this skillaws-samples/sample-strands-agent-with-agentcore194—~1.3kAutomated safety check: PassMIT
Meeting Brief GeneratorVarnan-Tech/opendirectory672—~2.2kAutomated safety check: NotesMIT
Meeting Preptechwolf-ai/ai-first-toolkit132—~1kAutomated safety check: PassMIT
Meeting Prep BriefBrianRWagner/ai-marketing-claude-code-skills4401 repos~922Automated safety check: PassNone
Luopan Company Researchzhangxiaoqiang1991/luopan388—~998Automated safety check: PassMIT
Company Researchstophobia/deerflow2.0-enhanced820—~845Automated safety check: PassMIT

Similar skills

  • Meeting Brief Generator

    Varnan-Tech/opendirectory

    Takes a company name and optional contact, runs targeted research via Tavily, synthesizes a 1-page pre-call brief with Gemini, and optionally saves it to Notion.

    672 GitHub stars~2.2k tokensUpdated 1 mo ago
    Sales & SupportAuto-check: notes
  • Meeting Prep

    techwolf-ai/ai-first-toolkit

    Comprehensive pre-meeting briefing that gathers all relevant context from Slack, email, Google Docs, Notion, and calendar.

    132 GitHub stars~1k tokensUpdated 8 days ago
    Productivity & AutomationAuto-check passed
  • Meeting Prep Brief

    BrianRWagner/ai-marketing-claude-code-skills

    Builds a pre-meeting brief from your Obsidian vault: participant research, past notes, open commitments, a prioritized agenda and sharp questions.

    440 GitHub starsUsed in 1 repo~922 tokens
    Sales & SupportAuto-check passed
  • Luopan Company Research

    zhangxiaoqiang1991/luopan

    罗盘的公司研究子模式。研究具体上市或非上市公司的财务增长、商业模式、 竞争生态位、治理与组织信号,并分别生成投资初筛和求职初筛。

    388 GitHub stars~998 tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Company Research

    stophobia/deerflow2.0-enhanced

    综合企业背景调研技能,用于尽职调查、合作伙伴评估、投资分析、市场研究等场景。支持公司工商信息、财务数据、法律风险、舆情分析、竞品对比等多维度调研,自动生成Markdown和HTML格式的专业调研报告。触发条件:用户提及"企业调研"、"公司背景"、"尽职调查"、"合作伙伴评估"、"投资分析"、"市场研究"等关键词。

    820 GitHub stars~845 tokensUpdated 6 mo ago
    Sales & SupportAuto-check passed
  • Sdt

    StopDisTrain/sdt-skills

    SDT 内容生产工具箱的总入口:根据当前任务选择最合适的 sdt- 模块,既能完成标题、开头等单一步骤,也能组织从账号研究到发布的完整流程。用户不知道该用哪个 SDT Skill,或希望一站式完成内容生产时使用。

    309 GitHub stars~535 tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed

More from aws-samples/sample-strands-agent-with-agentcore

All 24 skills in this repo
  • Doc Coauthoring

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Guide users through a structured workflow for co-authoring documentation.

    194 GitHub starsUsed in 39 repos~3.2k tokens
    Auto-check passed
  • Code Interpreter

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Test and prototype code in a sandboxed environment. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    194 GitHub stars~3.6k tokensUpdated yesterday
    Auto-check passed
  • Research Agent

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Deep research with structured reports and charts. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    194 GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Workspace

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Read and write files in the shared session workspace. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    194 GitHub stars~721 tokensUpdated yesterday
    Auto-check passed
  • Code Agent

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Autonomous coding agent. An agent skill from aws-samples/sample-strands-agent-with-agentcore.

    194 GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed
  • Delegate Work

    aws-samples/sample-strands-agent-with-agentcore

    Official

    Delegate one independent, context-heavy task to an isolated asynchronous analyst or reviewer.

    194 GitHub stars~610 tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about Notion

What does Notion do?

Search, read, create, and update Notion pages and databases. Notion is an agent skill from aws-samples/sample-strands-agent-with-agentcore, published by the product's own GitHub organization. Search, read, create, and update Notion pages and databases.

When should I use Notion?

Notion fits situations like: tasks that involve Sales call preparation.

How do I install Notion in Claude Code?

Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill notion -a claude-code`. Or copy the skill folder (chatbot-app/agentcore/skills/notion in aws-samples/sample-strands-agent-with-agentcore) into .claude/skills/notion in your project. Claude Code loads it when a task matches its description.

How do I install Notion in Codex?

Run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill notion -a codex`. Or copy the skill folder (chatbot-app/agentcore/skills/notion in aws-samples/sample-strands-agent-with-agentcore) into .agents/skills/notion in your project. Codex loads it when a task matches its description.

Can I use Notion in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add aws-samples/sample-strands-agent-with-agentcore --skill notion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion, .gemini/skills/notion, .github/skills/notion and .opencode/skills/notion in your project.

What does Notion need to run?

Going by SKILL.md and its folder, Notion needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Notion access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Notion safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notion use?

Notion is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notion use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notion?

Skills that share tags, products or a category with Notion: Meeting Brief Generator (Varnan-Tech/opendirectory, 672 stars), Meeting Prep (techwolf-ai/ai-first-toolkit, 132 stars), Meeting Prep Brief (BrianRWagner/ai-marketing-claude-code-skills, 440 stars) and Luopan Company Research (zhangxiaoqiang1991/luopan, 388 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notion?

aws-samples (a GitHub organization, an official publisher) maintains it in aws-samples/sample-strands-agent-with-agentcore, which has 194 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

Source: aws-samples/sample-strands-agent-with-agentcore on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.