mcpField
N
Notion MCP Server

Notion MCP Server

Local
github.com/edcolyerMemory & Knowledge0Updated 81w ago
Repository

About Notion MCP Server

Notion MCP Server connects Claude AI with Notion workspaces for reading and updating workspace content. It supports page and database search, queries and schema retrieval.

Key features

  1. 01Search workspace content
  2. 02Retrieve page content
  3. 03Retrieve database metadata and schema
  4. 04Query and filter database entries
  5. 05Update existing content

Use cases

  1. 01Find pages across a Notion workspace
  2. 02Read a specific page in Claude
  3. 03Inspect a database schema
  4. 04Filter database entries
  5. 05Update Notion content

MCP support

The MCP server exposes tools for searching Notion, retrieving pages and database schemas, querying and filtering database entries, and updating content.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Notion MCP Server

An MCP (Model Context Protocol) server implementation for seamless integration between Claude AI and Notion workspaces, enabling read and write capabilities.

Project Overview

This project aims to build an MCP server that connects Claude AI to Notion workspaces, allowing Claude to:

  • Read content from Notion databases and pages
  • Update existing content
  • Search across your Notion workspace
  • Query and filter database entries
  • Retrieve detailed page content and database schemas

Prerequisites

  • Node.js (v16+)
  • Notion API key
  • Claude Desktop

Getting Started

1. Set Up Notion API Access
  1. Create a Notion integration at https://www.notion.so/my-integrations
  2. Name your integration (e.g. "Claude MCP Integration")
  3. Set the integration type to "Internal"
  4. Copy your API key
  5. Share your Notion pages and databases with the integration by clicking the "..." menu in the top right of any page/database and selecting "Add connections"
2. Install Dependencies
npm install
3. Configure Environment Variables

Create a .env file in the project root with your Notion API key:

NOTION_API_KEY=your_api_key_here

This step is only needed if you're developing the server.

4. Build

Build the server, ready to be used by Claude.

npm run build

If you're developing the server, you can run npm run dev or npm run inspect.

5. Add to Claude Desktop config

Open claude_desktop_config.json (navigate to Settings > Developer and click Edit Config) and add the following:

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}
6. Restart Claude

Restart Claude and you should be good to go!

Available Features

The MCP server provides the following tools:

  • search_notion: Search across your Notion workspace using a query string
  • get_notion_page: Retrieve detailed content from a specific Notion page
  • get_notion_database: Retrieve metadata and schema of a Notion database
  • query_notion_database: Search and filter entries in a Notion database with support for complex queries

Resources and References

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.