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

0•

Collaboration Tools

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

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

01Automated .mcp.json configuration for Notion integration

02Intelligent merging with existing MCP server configurations

03Direct access to Notion API for page listing and creation

04Environment variable setup for secure API token management

05Supports markdown conversion for seamless content editing

060 GitHub stars

Use Cases

01Retrieving project specs or wiki pages to provide context for coding tasks

02Creating meeting notes or project documentation directly from the terminal

03Automating the migration of local markdown files to a Notion database

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add theflysurfer/claude-skills-marketplace julien-mcp-notion

For use in Claude.ai and ChatGPT

Download Skill