notion-mcp logo

notion-mcp

by Badhansen

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage a personal todo list. It allows interaction with Notion through functions like showing, adding, and updating tasks.

View on GitHub

Last updated: N/A

What is notion-mcp?

Notion MCP is a Model Context Protocol server that connects to Notion's API. It provides a way to manage a todo list within Notion using a defined set of functions.

How to use notion-mcp?

To use Notion MCP, you need to install it via Smithery or manually by cloning the repository, setting up a Python environment, configuring Notion API credentials, and adjusting the Claude Desktop configuration file. Then, you can use the provided functions (show_all_todos, add_todo, complete_todo) to interact with your Notion todo list.

Key features of notion-mcp

  • Integrates with Notion API

  • Manages todo lists

  • Supports adding tasks

  • Supports updating tasks

  • Supports showing all tasks

Use cases of notion-mcp

  • Managing personal todo lists in Notion

  • Integrating Notion with other applications via MCP

  • Automating task management in Notion

  • Building custom workflows with Notion data

FAQ from notion-mcp

What is a Notion integration token?

A Notion integration token is a credential that allows your application to access the Notion API on behalf of a user. You can create one at notion.so/my-integrations.

How do I share my Notion page with the integration?

Open your Notion workspace with a database/table present or a page. Click '...' menu → 'Add connections'. Select your integration (Search by name).

What is Claude Desktop?

Claude Desktop is a desktop application that can be integrated with Notion MCP to manage your todo list.

What is the purpose of the .env file?

The .env file stores sensitive information such as your Notion API token and page ID, keeping them separate from your code.

Where can I find the LICENSE file?

The LICENSE file is located in the root directory of the repository.