Notion in Claude Code.
Claude Code can search, read and write the Notion pages you share with it, and nothing else. Trashing a page needs your OK. This is for Claude Code on your own Mac or Linux computer.
passed Nov 16 · Notion CLI
fieldtrip add notionNew to fieldtrip? Install it first: curl -fsSL fieldtrip.sh/install | sh
Claude Code can
- Search and read the pages you share.
- Write and edit them, if you let it.
- Leave comments, if you let it.
Asks you first
- Trash a page.
- Delete what's on a page.
Can't do
- See pages you didn't share.
Try asking Claude Code
Paste one into Claude Code. Underneath: what it runs.
Find my roadmap page in Notion.
ntn api v1/search query=roadmapSummarise the Q4 plan page.
ntn pages get <page-id>Write up today's notes as a new page under Meetings.
ntn pages create --parent page:<id>your key needs Insert contentComment on the roadmap that the launch moved.
ntn api v1/comments …your key needs Insert commentsTrash the old draft page.
ntn pages trash <id> --yesasks you firstyour key needs Update content
How it’s set up for Claude Code
| the key | In Claude Code's own settings, ~/.claude/settings.json. Only the commands Claude Code runs can see it. Your Terminal can't. |
|---|---|
| the note | Saved as a Claude Code skill, ~/.claude/skills/notion. Claude Code reads it when you ask about Notion. It says how to use Notion, and what to check with you about first. |
| after setup | Quit Claude Code fully and reopen it. It reads its settings when it starts. |
| two checks | Unless you've turned it off, Claude Code also asks before it runs a command. fieldtrip's note adds a second check, on top of that one. |
| check it | Ask Claude Code on your computer to run fieldtrip doctor. It should say “Running in Claude Code” and show a ✓ beside Notion. |
Do this once.
- Make a connection in Notion, read-only to start, and share the pages your AI may use. fieldtrip will give you the link and tell you which boxes to tick, and why.
- Paste your key when fieldtrip asks you to.
Your key goes into your Terminal when fieldtrip asks. It never goes through Claude Code’s chat.
Checked every night
Yes. Notion 0.23.30 passed all five checks, Mon, Nov 16 · 11:09 AM CST.
Each square is one night.
Claude Code on the web
When you use Claude Code at claude.ai/code, it runs on a computer in the cloud, not yours. It can use Notion’s tool there too, but fieldtrip can’t set it up for you yet: you’d store your key as a secret in the cloud environment’s settings and install the tool yourself. We’ve done it by hand with Linear; Notion hasn’t been tested there yet.
← All of Notion: every AI, every version · Notion in Codex → · Notion in Cursor → · What’s a CLI?