noti

Notion CLI for AI Agents & Humans

Seamlessly integrate Notion into your AI-powered workflows

Quick Start •
Agent Skills •
CLI Usage •
日本語

---

Why noti?

noti bridges the gap between Notion and AI agents like Claude Code. Instead of manually copy-pasting content, let your AI assistant directly read, create, and manage your Notion workspace.

- AI-Native Design — Built as a Claude Code Agent Skill for seamless AI integration
- Full Notion API Coverage — Pages, databases, blocks, comments, and search
- Non-Interactive — All commands work without prompts, perfect for automation
- Markdown-First — Read and write content in familiar Markdown format

Quick Start

$3

``bash


Clone and build

git clone https://github.com/hirokidaichi/noti.git
cd noti
npm install && npm run build

Link globally (optional)

npm link
`

$3

Get your Integration Token from Notion Integrations, then:

`bash
noti configure --token
`

$3

`bash


Install to your home directory (available globally)

noti setup-skills --user

Or install to current project only

noti setup-skills --project
`

That's it! Claude Code will now have access to all noti commands.

Agent Skills

noti is designed to work as a Claude Code Agent Skill. Once installed, Claude can:

$3

`
"Read the meeting notes from last week"
"What tasks are marked as high priority in my project database?"
"Show me the latest entries in my journal"
`

$3

`
"Create a new page summarizing our discussion"
"Add a task to the project database with priority high"
"Append today's notes to my daily log"
`

$3

`
"Find all pages mentioning 'quarterly review'"
"List incomplete tasks sorted by due date"
"Export the customer database as CSV"
`

$3

`
"Set up an alias 'tasks' for my task database"
"Archive completed items from last month"
"Import this CSV data into the contacts database"
`

CLI Usage

All commands work in your terminal too:

$3

`bash
noti page get # Get page as Markdown
noti page create file.md # Create from Markdown
noti page update file.md -f # Update content
noti page append file.md # Append content
noti page remove -f # Delete page
`

$3

`bash
noti database list # List all databases
noti database query # Query database
noti database query -f "Status=Done" -s "Name:asc"
noti database export -f csv -o data.csv
noti database import -f data.csv -d
`

$3

`bash
noti search "keyword" # Search workspace
noti search "keyword" --json # JSON output
`

$3

`bash
noti alias add tasks # Create shortcut
noti open tasks # Open in browser
`

Command Reference

| Command | Description |
|---------|-------------|
| configure | Set up Notion API token |
| page | Page operations (get/create/update/append/remove) |
| database | Database operations (list/query/export/import/create) |
| search | Search pages and databases |
| block | Block operations (get/list/delete) |
| alias | Manage shortcuts to pages/databases |
| user | User information |
| open | Open page in browser |
| setup-skills | Install Agent Skills for Claude Code |

Examples

$3

`bash


Claude can create your standup notes


"Create a standup note for today with sections for Yesterday, Today, and Blockers"
`

$3

`bash


Export your important data


noti database export -f csv -o backup_$(date +%Y%m%d).csv
`

$3

`bash


Import data with validation


noti database import -f contacts.csv -d --dry-run # Validate first
noti database import -f contacts.csv -d # Execute
`

$3

`bash


Claude can help manage meeting notes


"Find the meeting notes from the product sync and summarize the action items"
"Create a follow-up page with the decisions we discussed"
`

Configuration

Config files are stored in ~/.config/noti/:

- config.json — API token and settings
- aliases.json — Page/database aliases

Requirements

- Node.js 18+
- Notion Integration Token
- Claude Code (for Agent Skills)

License

MIT

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature`)
5. Open a Pull Request

---

_{Built for the AI-powered workflow era}