Notionbae

NotionBae is a Model Context Protocol server built on .NET C# for seamless integration of AI assistants with Notion.com, providing functions such as searching, creating, and retrieving Notion page content.

Knowledge management and memory Developer tools #Notion Integration #AI Assistant #Data Synchronization #MCP Service .C#

rating : 2 points

downloads : 9.2K

update time : 2025-04-28

Open Site

What is NotionBae?

NotionBae is an MCP server built on .NET C#. It provides large language models (LLMs) with seamless interaction capabilities with Notion databases, pages, and content through the Notion API.

How to use NotionBae?

Through simple configuration and commands, you can easily enable AI assistants to collaborate with your Notion workspace. Whether it's searching for pages, creating new pages, or retrieving specific content, NotionBae can meet your needs.

Applicable Scenarios

Suitable for enterprise and individual users who need to automate the management of Notion tasks, such as knowledge base maintenance, project tracking, and team collaboration.

Main Features

Search Pages

Quickly find relevant pages in Notion based on keywords and return their titles and URLs.

Create New Page

Support customizing titles, descriptions, and Markdown-formatted content to generate new Notion pages.

Get Page Details

Retrieve all the content of a specific page by specifying the page ID.

Extract Block Content

Convert the child elements of a specified block or page into Markdown format for easy editing and sharing.

Advantages

Simplify the interaction process between AI assistants and Notion.

Support rich structured data processing capabilities.

Ensure the security and permission control of operations.

Limitations

Require pre - configuration of the Notion API key.

May have a certain dependence on the network environment.

How to Use

Go to the Notion official website to register an account and log in.

Create a Notion Integration

Create a new internal integration in the Notion Developer Center and record the generated API key.

Install NotionBae

Clone the NotionBae repository and run the dotnet build command in the local environment.

Configure VS Code

Edit the VS Code settings file and add the NotionBae server configuration.

Start the Server

Start the MCP server in VS Code or run it directly through the dotnet run command.

Usage Examples

Search Page Example

Demonstrate how to use the nb_search function to find relevant pages for a specific keyword.

Create New Page Example

Show how to use the nb_create_page function to create a new page containing Markdown content.

Frequently Asked Questions

Is NotionBae free to use?

How to update the Notion API key?

Which operating systems does NotionBae support?

Related Resources

NotionBae GitHub

The source code repository of the NotionBae project.

Model Context Protocol

The official homepage of the MCP framework.

Notion API Documentation

The official documentation of the Notion API.

🚀 NotionBae

A Model Context Protocol (MCP) server for Notion.com integration, built with .NET C#, based on ModelContextProtocol. NotionBae leverages the Notion API to enable seamless interaction between large language models and Notion workspaces.

🚀 Quick Start

NotionBae bridges the gap between large language models and Notion through the Model Context Protocol architecture, allowing AI assistants to interact with Notion databases, pages, and content in a structured manner.

✨ Features

Integrate the Notion API.
Implement an MCP-compatible server.
Process Notion content in a structured way.
Authenticate for secure access to Notion workspaces.

🛠️ Available Tools

NotionBae provides the following tools for interacting with Notion:

Tool Name	Description	Parameters
nb_search	Search for Notion pages and return their titles and public URLs.	`query`: String - A search query to find matching pages.
nb_create_page	Create a new Notion page with the given title, description, and content.	`parentId`: String - The ID of the parent page. `title`: String - The page title. `description`: String - The page description. `content`: String - The Markdown content of the page.
nb_get_page	Retrieve a Notion page by its ID.	`pageId`: String - The ID of the page to retrieve.
nb_retrieve_block_children	Retrieve the child blocks of a specified block or page ID and convert them to Markdown. In other words, get the content of a Notion page or block and convert it to Markdown.	`blockId`: String - The ID of the block or page to retrieve content from.

📦 Installation

1. Notion Account Setup

Create a Notion account: If you don't have one, visit notion.so to sign up.
Create a Notion integration:
- Go to Notion Developers.
- Click "New integration".
- Name the integration (e.g., "NotionBae").
- Select the workspace where you want to use it.
- Set appropriate permissions (at least select "Read content" and "Update content").
- Click "Submit" to create the integration.
Get your Notion API key: Create an integration in your Notion workspace settings. Refer to the Notion API documentation to learn how to create an integration and obtain an API key.

2. Installation and Running

Clone the repository:

git clone https://github.com/mrcunninghamz/NotionBae.git
cd NotionBae

Install dependencies:
```
dotnet restore
```
Run the server:
```
dotnet run
```

3. Configure Environment Variables

Make sure to set the following environment variables:

NotionApiKey: Your Notion API key for authenticating with the Notion API.

4. Usage Instructions

Start via VS Code:
- Open the "Command Palette" (Mac: Cmd+Shift+P, Windows/Linux: Ctrl+Shift+P).
- Type "MCP: Start Server" and select it from the dropdown list.
- Select "NotionBae" from the list of available servers.
Run directly from the command line:
```
dotnet run
```

📚 Related Projects

This project is part of the "Bae" toolset:

TestBae - A .NET testing utility library that simplifies the use of fixtures, mocks, and common testing patterns for more efficient and maintainable test suites.
AzBae - Azure DevOps tools that provide CLI and GUI interfaces to simplify Azure resource management, deployment, and DevOps workflows.