Notion Plugin for Claude Code

This repository provides an official Claude Code plugin that bundles:

• Notion Skills (from the Notion Cookbook) that teach Claude how to work intelligently inside your Notion workspace
• The Notion MCP Server, which enables Claude to securely search, read, and update your Notion content
• A curated set of Slash Commands that make common Notion workflows fast and natural

This plugin allows Claude Code users to install everything — Skills + MCP server — with one click.

---

🚀 Features

✅ Fully packaged Notion Skills

Includes 12 Skills from the Notion Cookbook:

• Database designer — Design Notion databases
• Meeting intelligence — Prepare meetings and follow-ups
• Research documentation — Research and write cited docs
• Spec to implementation — Turn specs into plans and tasks
• Weekly project digest — Summarize progress, blockers, and next steps
• Build my engineering wiki — Bring technical docs and projects together
• Create my team handbook — Organize team knowledge and procedures
• Knowledge capture — Turn conversations into reusable docs
• Organize my semester — Keep courses, notes, and deadlines together
• Plan marketing campaigns — Organize campaigns, content, and production
• Set up my project — Create a project home with tasks and docs
• Set up Notion — Connect Notion and get started

The skills include their supporting references, examples, evaluation scenarios, and display metadata. Skill sources are maintained in the Notion Cookbook and mirrored into skills/notion/ here.

✅ Integrated Notion MCP Server

Claude Code automatically connects to Notion's hosted MCP server at:

https://mcp.notion.com/mcp

This provides Claude with tools to:

• Search your workspace
• Retrieve pages & databases
• Create and update pages
• Append notes or blocks
• Insert database rows
• Work with properties safely

✅ Powerful Slash Commands

This plugin ships with a set of helpful commands:

Command	Description
/Notion:search	Search your entire Notion workspace
/Notion:create-page	Create a new page under a given parent
/Notion:database-query	Query a database by name or ID
/Notion:create-task	Create a task in a Tasks-style database
/Notion:create-database-row	Insert a row in any database
/Notion:find	Quick title-based search for pages/databases
/Notion:tasks:setup	Set up a Notion task board for tracking
/Notion:tasks:build <url>	Build a task from a Notion page URL
/Notion:tasks:plan <url>	Make a plan for a task from a Notion page URL
/Notion:tasks:explain-diff	Generate a Notion doc explaining code changes

These commands leverage both the Notion Skills and the MCP server.

---

📦 Installation (Claude Code)

1. Add this plugin's marketplace

In Claude Code, run:

/plugin marketplace add makenotion/claude-code-notion-plugin

2. Install the plugin

/plugin install notion-workspace-plugin@notion-plugin-marketplace

3. Restart Claude Code

This ensures the MCP server starts correctly.

---

🔑 Authentication

The Notion MCP server supports OAuth!

---

🙌 Credits

• Skills by the Notion
• MCP Server by Notion
• Plugin Specification by Anthropic