snahrup/claude-protocol-mcp

Claude Protocol MCP

A streamlined MCP server for efficient Claude Protocol operations with Notion workspaces.

📦 Quick Install (NPM)

npm install -g claude-protocol-mcp
npx claude-protocol-setup

🎯 Features

• 🚀 Smart Template Setup: Automatically duplicate and configure the complete Claude Context Template
• ⚙️ Auto-Detection: Intelligently finds your databases after template duplication
• 📝 Streamlined Chat Management: Create, resume, and track chat sessions with rich metadata
• 🔗 Smart Context Loading: Automatically load relevant project context for seamless continuations
• 🆔 Session Continuity: Seamless conversation handoffs with auto-generated session IDs
• 🌐 Universal Configuration: Works with any Notion workspace - fully customizable
• ⚡ Efficient: Minimal context usage, maximum functionality

🚀 Quick Setup

Option 1: NPM Install (Recommended)

npm install -g claude-protocol-mcp
npx claude-protocol-setup

Option 2: Clone from GitHub

git clone https://github.com/snahrup/claude-protocol-mcp.git
cd claude-protocol-mcp
npm install
npm run setup

🎯 The Smart Setup Process

The setup wizard guides you through everything:

1. 🔑 Notion Integration: Validates your API token
2. 🎯 Template Duplication: Shows you exactly where to click "Duplicate"
3. 🔍 Auto-Detection: Finds your new databases automatically
4. ⚙️ Configuration: Generates everything for you
5. 🏗️ Build & Test: Confirms everything works

Template URL: https://short-sidecar-46e.notion.site/Claude-Context-Template-244632e81d3a811c9936fe3021eb5ce9

🛠️ Available Tools

Once installed, you can use natural language with Claude:

Chat Session Management

• "Save this conversation as 'API Planning Session'"
• "Resume session Claude-20250804140000"
• "What's the context for my current project?"

Status and Overview

• "Show me my recent chat sessions"
• "What projects am I working on?"
• "What's my quick status?"

Session Continuations

• "This chat is getting long, save it and continue in a new session"
• "Mark this session as complete"

Smart Optimization

• "Analyze the best approach for database optimization" _( prefix triggers enhancement)_

📊 What Gets Created

The smart setup creates a complete Claude Protocol workspace:

📝 Chats Database

• Session tracking with auto-generated IDs
• Context status management (Active, Continued, Complete)
• Rich metadata (participants, chat types, priorities)
• Project relationships and task linking
• Key decisions and next actions tracking

📁 Projects Database

• Project lifecycle management (Not started → In progress → Done)
• Priority and function categorization
• Goal tracking and AI summaries
• Related chats and tasks relationships

✅ Tasks Database

• Task status tracking with sub-item support
• Project relationships and assignee management
• Due date tracking and progress monitoring

🔗 Connect to Claude Desktop

The setup automatically provides your configuration:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "claude-protocol": {
      "command": "node", 
      "args": ["/your/full/path/to/dist/index.js"]
    }
  }
}

🎮 Using the MCP

After setup, just talk to Claude naturally:

Saving Sessions

You say: "Save this conversation about API integration planning. We decided to use REST and implement rate limiting. Next steps are to create endpoints and test auth."

Claude does: Creates a comprehensive chat summary with all metadata, links to your project, auto-generates session ID

Resuming Sessions

You say: "Resume session Claude-20250804140000"

Claude does: Loads complete context - chat summary, project details, active tasks, recent conversations

Getting Context

You say: "What's the current context for my task management project?"

Claude does: Shows recent chats, active tasks, project status, related work

Session Continuations

You say: "We're hitting the context limit, continue this in a new session"

Claude does: Saves current session as "Continued", creates new session with proper linking

🔧 Commands Reference

🆘 Troubleshooting

Setup Issues

• "No databases found": Make sure you successfully duplicated the template
• "Token validation failed": Check your Notion integration token
• "Database access denied": Share your integration with all databases

Connection Issues

• "Configuration file not found": Run setup first
• "MCP server not connecting": Check absolute paths in Claude Desktop config
• "Build failed": Ensure Node.js 18+ is installed

Common Fixes

# Reconfigure everything
npx claude-protocol-setup

# Test your connection  
npm run test-connection

# Rebuild manually
npm run build

📈 Why This Approach Works

Before Claude Protocol MCP:

• ❌ Scattered conversations with no continuity
• ❌ Lost context when hitting limits
• ❌ No organization or searchability
• ❌ Manual session management

After Claude Protocol MCP:

• ✅ Organized: Every chat saved with rich metadata
• ✅ Searchable: Find conversations by project, topic, decisions
• ✅ Continuous: Seamless session handoffs with full context
• ✅ Automated: Just talk naturally, everything happens automatically

🌟 Real User Experience

"I just say 'Save this session about database optimization' and Claude automatically:

• Creates a properly numbered chat summary
• Links it to my project
• Extracts key decisions and next actions
• Generates a resumable session ID
• Updates all the relationships

Then later I can say 'Resume my database optimization work' and Claude loads everything - the previous context, active tasks, related conversations. It's like having a perfect memory that never forgets where we left off."

📄 License

MIT License - feel free to customize for your needs!

🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Test with your Notion workspace
4. Submit a pull request

🆘 Support

• Template: https://short-sidecar-46e.notion.site/Claude-Context-Template-244632e81d3a811c9936fe3021eb5ce9
• Issues: https://github.com/snahrup/claude-protocol-mcp/issues
• NPM: https://npmjs.com/package/claude-protocol-mcp

Built for the Claude Protocol community 🚀

Transform your Claude conversations from scattered chats into organized, searchable, and resumable sessions with complete context continuity.