Connect Notion to AI agents over MCP (with Stepper Skill Sets)

What you can let an agent do in Notion

These are the Notion actions you can add to a Skill Set. They're the same actions Stepper workflows use, listed on Stepper's Notion page. You choose which ones the agent gets.

For example, you could ask

• Search Notion for the workshop planning page and add a to-do for booking the kiln.
• Create an item in the Orders database for Tidewater Clay and set the status to New.

• Create Page Create a new page in Notion
• Create Database Create a new database in Notion (Advanced)
• Search Pages Search for pages in Notion
• Search Databases Search for databases in Notion
• Add Comment Add a comment to a page or block in Notion
• Add Content to Page Add a block to an existing page in Notion
• Update Database Item Update a database item in Notion
• Get Page Comments Get comments for a page in Notion
• Get Page or Database Item by ID Retrieve a page or database item by its ID
• Get Page Property Get a specific property of a page
• Get User Details Get details of a user
• Archive Database Item Archive a database item in Notion
• Create Database Item Create a new item in a database
• Restore Database Item Restore an archived database item
• Update Database Schema (Advanced) Update the schema/properties of a database
• Retrieve Database by ID Retrieve a database and its schema
• Retrieve Block Children Retrieve the children of a specific block
• Find Database Items (advanced) Find items in a database with filters and sorting
• Get Page and Children Get a page along with all its child blocks
• Find or Create Database Item Find an existing database item or create a new one if not found
• Create or Update Database Item Create or update a database item
• Make HTTP Request Make an HTTP request to any URL with full control over method, headers, and body.

Set it up in 5 steps

You need a Stepper account, a Notion account, and an AI client that supports remote MCP servers, such as ChatGPT, Claude, Cursor or VS Code. Your own agent works too, using a Skill Set token.

1. Connect Notion to Stepper

   In Stepper, connect your Notion account. Use an account that can do what you want the agent to do, and no more.

2. Create a Skill Set

   Go to Skill Sets in Stepper, create a Skill Set for this agent, and use Add Entry to add your Notion connection.

3. Restrict the actions

   Choose only the Notion actions the agent needs. An entry with no actions chosen allows every Notion action, so a short list is safer. To pin a value, such as one channel, table or calendar, hardcode that parameter so the agent can't change it.

4. Add the Skill Sets server to your AI client

   Add this URL as a remote MCP server:

   https://mcp.stepper.io/skill-sets/mcp Copy

   Then sign in to Stepper when your client asks. On the Stepper screen that follows, pick the Skill Set this agent should use. To switch to a different Skill Set later, remove the server and connect again.

   Chat apps (ChatGPT, Claude and others): add it as a custom connector or app, wherever your client lists remote MCP servers.

   Code editors (Cursor, Windsurf and others that use an mcpServers config):

   {
     "mcpServers": {
       "stepper": {
         "url": "https://mcp.stepper.io/skill-sets/mcp"
       }
     }
   }

   Your own agent or script: generate a Skill Set token in Stepper and send it as Authorization: Bearer sst_….

5. Test it

   Ask the agent what it can do (it checks the Skill Set's list of skills) and make sure only the Notion actions you chose appear. Then run one request using the lowest-risk action you allowed, such as a lookup or a draft, and check the call in the Skill Set's call log in Stepper.

Notion's own MCP server, and when to use it instead

Guardrails

An agent can misread a request, and some Notion actions change or remove real data. Set these up before you rely on it.

Add with care: Make HTTP Request. Make HTTP Request can call any URL with your connection, so it gives the agent far more reach than the other actions.