Notion CLI - A command-line interface for Notion
npm install @hirokidaichi/noti
Notion CLI for AI Agents & Humans
Seamlessly integrate Notion into your AI-powered workflows
Quick Start •
Agent Skills •
CLI Usage •
日本語
---
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
``bashClone and build
git clone https://github.com/hirokidaichi/noti.git
cd noti
npm install && npm run build
$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 --userOr 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 aliasesRequirements
- 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`)---
Built for the AI-powered workflow era