MCP.so
Sign In

Notion MCP Server

@Badhansen

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

Badhansen

About Notion MCP Server

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.

Notion MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notion-mcp-badhansen": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Badhansen/notion-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Notion MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is notion-mcp?

A Model Context Protocol (MCP) server that integrates with Notion's API to manage a personal todo list, designed for use with the Claude Desktop client.

How to use notion-mcp?

Install via Smithery with npx -y @smithery/cli install @Badhansen/notion-mcp --client claude, or clone the repository, set up a Python virtual environment, configure Notion credentials in a .env file, and add the server configuration to claude_desktop_config.json. Then invoke functions like show_all_todos, add_todo, or complete_todo through Claude.

Key features of notion-mcp?

  • Integrates with Notion API for task management
  • Supports showing all todos
  • Supports adding new todos
  • Supports completing existing todos
  • Designed for Claude Desktop client
  • Simple installation via Smithery or manual clone

Use cases of notion-mcp?

  • Manage a personal todo list in Notion via Claude
  • Retrieve all tasks with a single command
  • Add tasks using natural language
  • Mark tasks as complete without leaving Claude

Frequently asked questions

1

What does notion-mcp do?

It is an MCP server that lets Claude Desktop interact with your Notion workspace to manage a todo list.

2

What prerequisites are required?

Python 3.11 or higher, a Notion account with API access, a Notion integration token, a Notion page for the todo list, and the Claude Desktop client.

3

How is notion-mcp installed?

It can be installed automatically via Smithery or by cloning the repository, creating a Python virtual environment with `uv`, and configuring a `.env` file.

4

How are Notion credentials configured?

Set `NOTION_TOKEN`, `PAGE_ID`, `NOTION

Comments

More Memory & Knowledge MCP servers