Why can't Claude see my Notion pages after installation?

For security reasons, you must manually share specific Notion pages or databases with your integration via the 'Share' menu in the Notion interface.

How do I get a Notion API Token?

Navigate to notion.so/my-integrations, create a new internal integration, and copy the provided Secret token to use as your NOTION_API_TOKEN.

Do I need to restart Claude after installation?

Yes, once the .mcp.json file is created or updated, you must restart your Claude Code session to activate the newly added Notion capabilities.

What happens if I already have other MCP servers configured?

This skill detects your existing .mcp.json file and merges the Notion configuration into the mcpServers object without overwriting your other tools.

Does this skill support markdown formatting?

Yes, by setting the NOTION_MARKDOWN_CONVERSION environment variable to 'true' during setup, the server will handle markdown conversion automatically.

Notion MCP Workspace Integration

Name: Notion MCP Workspace Integration
Author: theflysurfer

bytheflysurfer

Collaboration Tools

Integrates Notion into your Claude Code workspace to manage pages and databases via the Notion API.

About

This skill automates the setup and configuration of the Notion Model Context Protocol (MCP) server within your Claude Code environment. By managing the installation of the @suekou/mcp-notion-server and configuring the necessary environment variables in your project's .mcp.json file, it enables Claude to directly interact with your Notion workspace. Users can list pages, create new content, and retrieve documentation without leaving the terminal, significantly streamlining workflows that involve project wikis, team notes, or task tracking.

Key Features

Automated .mcp.json configuration for Notion integration
Intelligent merging with existing MCP server configurations
Direct access to Notion API for page listing and creation
Environment variable setup for secure API token management
Supports markdown conversion for seamless content editing
0 GitHub stars

Use Cases

Retrieving project specs or wiki pages to provide context for coding tasks
Creating meeting notes or project documentation directly from the terminal
Automating the migration of local markdown files to a Notion database

About

Key Features

Automated .mcp.json configuration for Notion integration
Intelligent merging with existing MCP server configurations
Direct access to Notion API for page listing and creation
Environment variable setup for secure API token management
Supports markdown conversion for seamless content editing
0 GitHub stars

Use Cases

Retrieving project specs or wiki pages to provide context for coding tasks
Creating meeting notes or project documentation directly from the terminal
Automating the migration of local markdown files to a Notion database