Notion + Msty Studio: Complete MCP Integration
Notion is a MCP server that Notion's official hosted MCP server providing secure AI tool access to workspace content including pages, databases, and comments through OAuth authentication..
When integrated with Msty Studio, you can:
- Search and retrieve live context from Notion workspace based on user access and permissions
- Access and query Notion databases to retrieve structured information
- Read page content and metadata from workspace pages you have access to
This guide provides step-by-step instructions to set up Notion in Msty Studio, including configuration, examples, and troubleshooting.
What You'll Achieve
After completing this setup:
- Notion will be fully integrated and operational
- You can use Notion tools directly in Msty Studio
- All Notion capabilities will be available for your workflows
- Access to 4 different tools
Prerequisites
Before starting, ensure you have:
- Node.js 18 or higher (for STDIO transport only)
- Active Notion workspace with appropriate access permissions
- MCP client that supports remote servers (HTTP/SSE) or STDIO transport
- Notion account with workspace access
- Supported AI tool with MCP client capabilities
- Permission to connect external applications to workspace
- Msty Studio installed and configured
- Compatible operating system (Desktop (Windows), Desktop (macOS), Desktop (Linux), Web Application)
Installation
Step 1: Install Notion
Install using npm:
npx -y mcp-remote https://mcp.notion.com/mcp
Verify installation:
Connection verified through OAuth flow in your AI tool
Configuration
Step 2: Configure Msty Studio
- Open Msty Studio settings
- Navigate to MCP server configuration
- Add Notion server with appropriate settings
- Save and restart if needed
Examples
Once configured, you can use Notion in Msty Studio:
Create Project Documentation
Generate PRDs, tech specs, or architecture docs by pulling context from existing Notion pages
Ask Msty Studio: "Create a technical specification for the new authentication system based on our security guidelines in Notion"
Expected Result: AI retrieves security guidelines from Notion workspace and generates comprehensive tech spec
Track Campaign Progress
Monitor and report on campaign status using Notion database data
Ask Msty Studio: "Give me a summary of all marketing campaigns in progress with their current metrics"
Expected Result: AI queries the campaigns database and provides formatted progress report
Search Meeting Notes
Find specific information across all meeting notes in workspace
Ask Msty Studio: "What decisions did we make about the API redesign in recent meetings?"
Expected Result: AI searches meeting notes and returns relevant decisions with links to source pages
Generate Release Notes
Build release documentation by aggregating information from multiple Notion pages
Ask Msty Studio: "Create release notes for version 2.0 using our changelog and feature pages"
Expected Result: AI compiles information from multiple pages into formatted release notes
Task Management
Query and analyze tasks from Notion databases
Ask Msty Studio: "Show me all overdue tasks assigned to the engineering team"
Expected Result: AI filters and presents overdue engineering tasks with details and links
Testing Your Setup
- Launch Msty Studio
- Verify Notion is available in the tools list
- Test basic Notion functionality
Troubleshooting
Common Issues
AI Tool Cannot Connect to Notion MCP
Symptoms: Connection timeout or failed errors, Notion MCP not appearing in tool directory, OAuth flow not starting
Cause: AI tool may not support MCP clients or remote MCP connections
Solution:
- Verify your AI tool supports MCP client functionality
- Check if tool supports remote MCP servers (HTTP/SSE transport)
- For tools without remote support, use STDIO with mcp-remote proxy: npx -y mcp-remote https://mcp.notion.com/mcp
- If tool lacks MCP support entirely, request feature from developers
OAuth Connection Fails
Symptoms: Authorization screen does not appear, Cannot complete OAuth flow, Connection succeeds but no workspace access
Cause: OAuth flow interrupted or workspace permissions issue
Solution:
- Use Notion app Settings > Connections > Notion MCP for easiest setup
- Ensure popup blockers are disabled during OAuth
- Check you have appropriate workspace permissions
- Try disconnecting and reconnecting through Notion app
Cannot Access Specific Pages or Databases
Symptoms: Some content returns not found errors, Searches return incomplete results, Database queries fail or return empty
Cause: Content access based on user permissions - AI tool can only see what you can see
Solution:
- Verify you have access to the pages/databases in Notion app
- Check workspace sharing settings for restricted content
- Ensure pages are not in private sections you cannot access
- Contact workspace admin if you need broader access
STDIO Transport Connection Issues
Symptoms: mcp-remote command fails, Connection drops frequently, Slow response times
Cause: STDIO transport requires mcp-remote proxy for hosted Notion MCP
Solution:
- Prefer Streamable HTTP or SSE transport if your tool supports it
- Ensure Node.js and npx are properly installed for STDIO
- Use config: npx -y mcp-remote https://mcp.notion.com/mcp
- Check network connectivity to mcp.notion.com
Tool Does Not Support Remote MCP Servers
Symptoms: Only local/STDIO servers work in tool, HTTP/SSE connections not available, No option to add remote server URL
Cause: Some MCP clients only support local STDIO servers
Solution:
- Use mcp-remote as proxy to convert HTTP to STDIO
- Configuration: command: npx, args: [-y, mcp-remote, https://mcp.notion.com/mcp]
- Alternative: Use open-source notion-mcp-server for local deployment
- Check tool documentation for remote server support roadmap
MCP Server Not Connecting
Symptoms: Server shows disconnected status, Tool calls fail, Timeout errors
Cause: Invalid configuration or server not accessible
Solution:
- Verify MCP server URL or command is correct
- For STDIO servers, ensure Node.js and npx are installed
- Check firewall settings allow connections
- Review server logs in Toolbox dashboard
- Test server independently outside Msty
Local Model Performance Issues
Symptoms: Slow response times, High memory usage, System freezes
Cause: Model size exceeds hardware capabilities
Solution:
- Use smaller model variants (e.g., Llama 3 8B instead of 70B)
- Enable quantization for reduced memory footprint
- Close other applications to free resources
- Consider using cloud models for complex tasks
- Check system requirements for selected model
Privacy Mode Not Working
Symptoms: Data appears to be sent externally, Telemetry detected, Unexpected network activity
Cause: Cloud models or online MCP servers configured
Solution:
- Ensure using only local models (Llama.cpp-based)
- Configure STDIO MCP servers instead of HTTP/SSE
- Disable internet connection to verify offline capability
- Review Insights dashboard for token usage (should be zero for local)
- Check Privacy settings are configured correctly
Turnstile Workflow Failures
Symptoms: Workflow stops mid-execution, Steps not triggering, Incorrect branching
Cause: Logic errors or MCP server issues
Solution:
- Test each workflow step individually
- Verify all MCP servers in workflow are connected
- Review workflow logic and conditions
- Check Turnstile logs for execution errors
- Simplify complex workflows for debugging
Cross-Device Sync Problems
Symptoms: Settings not syncing, Conversations missing, Inconsistent state
Cause: Sync service issues or Aurum plan not active
Solution:
- Verify Aurum plan is active and current
- Check internet connection on all devices
- Manually trigger sync from settings
- Review sync logs for errors
- Contact support if issues persist
Notion not appearing in Msty Studio
Symptoms: Server not listed, Tools not available
Cause: Configuration or installation issue
Solution:
- Verify configuration syntax
- Check Notion installation
- Restart Msty Studio
- Check logs for error messages
Next Steps
Now that Notion is integrated with Msty Studio:
- Explore all Notion capabilities through Msty Studio
- Check out other MCP servers that work with Msty Studio
- Join the MCP community for tips and support
- Consider contributing to Notion development
Need Help?
- Search for Notion documentation
- Check the Msty Studio MCP guide
- Join the MCP community discussions