SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Notion MCP with Hermes

Connect Hermes to Notion MCP. Summarize recent meeting notes in notion, create a notion project page from tasks, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Notion MCP logoNotion MCP
Dcr Oauth

Notion MCP is a service that exposes Notion pages, databases, search, and tasks to integrations. Use it to give agents structured, authenticated access to your Notion workspace.

37 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Notion account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Notion MCP with

ChatGPTClaude CoworkAtomic Agent

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Notion with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Notion

Ask your agent to connect to Notion, or simply request any Notion-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Notion connection.

Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Notion or request any Notion-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Notion MCP server, and what's possible with it?

The Notion MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Notion account. It provides structured and secure access so your agent can perform Notion operations on your behalf.

Way Forward

With Notion connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Notion MCP action and event your agent gets out of the box.

Notion-convert-page-to-skill

Mark an existing Notion page as a skill without changing its content.

Notion-create-attachment

Create an attachment and upload it to Notion.

Notion-create-comment

Add a comment to a page or specific content.

Notion-create-database

Creates a new Notion database using SQL DDL syntax, or a canonical typed database for tasks, projects, or skills.

Notion-create-file-upload

Create a short-lived URL for uploading one local file directly to Notion.

Notion-create-folder

Creates an empty Notion Folder.

Notion-create-pages

## Overview Creates one or more Notion pages, with the specified properties and content.

Notion-create-view

Create a new view on a Notion database.

Notion-download-attachment

Download the contents of a small UTF-8 text attachment created by the Notion MCP `create-attachment` tool.

Notion-duplicate-page

Duplicate a Notion page.

Notion-fetch

Retrieves details about a Notion entity (page, database, data source, or saved database view) by URL or ID.

Notion-get-async-task

Retrieves the current status of an async task that was started by another tool (for example, "create_pages" called with "allow_async": true).

Notion-get-comments

Get comments and discussions from a Notion page.

Notion-get-session-status

Get the latest turn's status for a Custom Agent session without waiting.

Notion-get-teams

Retrieves a list of teams (teamspaces) in the current workspace.

Notion-get-users

Retrieves a list of users in the current workspace.

Notion-list-favorite-pages

List the current user's favorite pages and databases in sidebar order.

Notion-list-private-pages

List the current user's top-level pages and databases in their Private sidebar section.

Notion-list-recent-pages

List pages and databases the current user recently viewed, ranked by recency and visit frequency.

Notion-list-session-events

List short summaries of saved events in a Custom Agent session.

Notion-list-shared-pages

List pages and databases in the current user's Shared sidebar section.

Notion-move-pages

Move one or more Notion pages or databases to a new parent.

Notion-query-data-sources

Query data from Notion databases using SQL or by specifying a view.

Notion-query-meeting-notes

Query the current user's meeting notes data source.

Notion-query-sessions

List agent sessions available to the integration.

Notion-read-session-event

Read the full visible content of one saved Custom Agent session event.

Notion-search

Search the user's Notion workspace and connected sources (Slack, Google Drive, GitHub, Jira, Teams, SharePoint, OneDrive, Linear) and return a ranked list of results to read.

Notion-search-agents

Search agents by name or description, or browse the current user's favorite agents and the workspace's newest agents.

Notion-search-sessions

Search past agent sessions by topic in a periodically refreshed index and return matching session URLs and excerpts.

Notion-send-message-to-session

Send a follow-up message to a Custom Agent session you can access.

Notion-spawn-session

Start a session with a published Custom Agent.

Notion-stop-session

Stop a running Custom Agent session you can access.

Notion-update-data-source

Update a Notion data source's schema, title, or attributes using SQL DDL statements.

Notion-update-folder

Update an existing Notion Folder with an explicit Folder operation.

Notion-update-page

## Overview Update a Notion page's properties or content.

Notion-update-view

Update a view's name, filters, sorts, or display configuration.

Notion-wait-session

Wait for the latest turn in a Custom Agent session to stop running.

FRAMEWORKS

How to build Notion MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Notion MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Notion MCP with Claude Cowork

Atomic Agent logo

Atomic Agent

Use Notion MCP with Atomic Agent

FAQ

Frequently asked questions

With a standalone Notion MCP server, the agents and LLMs can only access a fixed set of Notion tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Notion and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Notion tools.

Yes, absolutely. You can configure which Notion scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Notion data and credentials are handled as safely as possible.

Start with Notion MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Notion MCP tool your agent needs.Free to start.

Start building