Noverload MCP Server

Connect your Noverload saved content to AI assistants like Claude, Cursor, and Windsurf using the Model Context Protocol (MCP).

🚀 Release v0.7.0 - Major expansion with 23 advanced tools for content analysis, framework extraction, narrative building, and knowledge synthesis.

🚀 Powered by Noverload API v2 for advanced search, content synthesis, and intelligent token management.

Quick Start

1. Get your token: Generate a Personal Access Token from your Noverload dashboard

2. Copy the config: Use the zero-install configuration below with your token

3. Add to your AI tool: Paste into Claude Desktop, Cursor, or Windsurf settings

4. Start using: Ask your AI about your saved content!

Features

• 📚 Access all your saved content (YouTube, X posts, Reddit, articles, PDFs)

• 🔍 Advanced search with multiple modes (smart, semantic, fulltext)

• ⚠️ Token warnings for large content (prevents context overflow)

• ✅ View and complete action items

• 🎯 Goals tracking

• 🧠 Content synthesis and insights generation

• 🔒 Secure access with personal access tokens

• 📝 Read-only mode by default for safety

Installation

For Users

Recommended: Zero-Install with NPX

No installation needed! NPX automatically downloads and runs the latest version:

Alternative: Global Install

For faster startup (but requires manual updates):

Then use:

For Development

Configuration

Step 1: Get Your Personal Access Token

1. Log in to Noverload

2. Go to Settings → API Access

3. Click "Generate Personal Access Token"

4. Copy the token (you won't be able to see it again)

Step 2: Configure Your AI Tool

Claude Desktop

Edit your Claude configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Cursor

1. Open Cursor Settings

2. Navigate to Features → Model Context Protocol

3. Add configuration:

Windsurf

Add to your Windsurf MCP configuration:

Available Tools

23 powerful tools organized into categories for comprehensive content analysis:

Content Retrieval & Access

• list_saved_content - Browse your saved content library with filtering

• get_content_details - Get full details including summaries and insights

• get_raw_content - Access raw text content for processing

• batch_get_content - Efficiently retrieve multiple items at once

Search & Discovery

• search_content - Advanced search with multiple modes and filters

• find_similar_content - Discover semantically similar content

• expand_search - Expand queries with related terms for broader discovery

Analysis & Synthesis

• synthesize_content - Create comprehensive analysis from multiple sources

• explore_topic - Deep dive into topics across your content

• find_connections - Discover patterns and relationships between content

• extract_insights - Extract key takeaways and actionable insights

• get_timeline - Build chronological understanding of topics

• build_knowledge_graph - Visualize concept relationships

• extract_frameworks - Identify methodologies and structured approaches

• find_examples - Locate specific examples and case studies

• build_narrative - Create coherent stories from multiple sources

Content Management

• save_content - Save new URLs to your library (write mode only)

• smart_sections - Organize content into intelligent sections

Actions & Goals

• list_actions - View extracted action items with priorities

• complete_action - Mark action items as done (write mode only)

• list_goals - Access your Health, Wealth, Relationships goals

Utility & Planning

• estimate_search_tokens - Preview token usage before large operations

• get_instructions - Access user-specific guidance and context

• plan_query - Strategically plan complex multi-step analyses

Security Recommendations

1. Use Read-Only Mode: Keep readOnly: true in your configuration unless you specifically need write access

2. Protect Your Token: Never share your personal access token

3. Revoke When Needed: You can revoke tokens anytime from Noverload settings

4. Scope Appropriately: Consider creating separate tokens for different use cases

Self-Hosting

If you prefer to run your own instance:

Option 1: Local Development Server

Option 2: Deploy to Your Infrastructure

The MCP server can be deployed to any Node.js hosting platform:

1. Vercel/Netlify Functions: Deploy as a serverless function

2. Docker Container: Package and run anywhere

3. VPS: Run on your own server with PM2

Example Dockerfile:

Option 3: Private NPM Registry

Host on your own NPM registry for team distribution:

API Endpoints Required

For self-hosting, your Noverload API needs these endpoints:

• GET /api/user - Validate access token

• GET /api/content - List saved content

• GET /api/content/:id - Get content details

• POST /api/content - Save new content

• GET /api/content/search - Search content

• GET /api/actions - List actions

• POST /api/actions/:id/complete - Complete action

• GET /api/goals - List goals

Development

Project Structure

Testing Locally

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests if applicable

5. Submit a pull request

Troubleshooting

"Invalid access token"

• Ensure your token is correctly copied

• Check if the token has expired

• Verify you're using the correct API URL

"Client not initialized"

• Restart your AI assistant after configuration changes

• Check the configuration JSON syntax

Tools not appearing

• Ensure the MCP server is properly configured

• Check your AI assistant's MCP logs

• Try reinstalling the package

License

MIT

Support

• Issues: GitHub Issues

• Documentation: Noverload Docs

• Discord: Join our community