Installing prequisites

Connecting to Notion MCP

Learn how to connect your AI tool to Notion using MCP.

This guide walks you through connecting your AI tool to Notion using the Model Context Protocol (MCP). Once connected, your tool can read and write to your Notion workspace based on your access and permissions.

Run this command in your terminal:

claude mcp add --transport http notion <https://mcp.notion.com/mcp>

Then authenticate by running /mcp in Claude Code and following the OAuth flow.

Using --scope flag for different installation scopes

Read more here.

Downloading the Claude Skill

Follow these steps to install and run the Claude skill locally:

1. Clone the repository:
   • git clone <https://github.com/ArziTech/project-notion>
2. Run Claude with the plugin directory (replace $GITHUB_CLONE_PATH with the folder where you cloned the repo):
   • claude --plugin-dir $GITHUB_CLONE_PATH/project-notion

Note: This plugin is still under review on the Claude Plugin Marketplace.

Read more about claude plugins here.

Init the Project, Creating PROJECT-NOTION.md

To help the plugin understand your project (and know where to create Projects/Milestones/Tasks pages), you must provide project context in a file named PROJECT-NOTION.md.

You do not need to create this file manually.

1. Run the init-project-notion skill.
2. Follow the prompts to select/provide your Project page ID and Milestone IDs.