NoverloadNoverload

Model Context Protocol (MCP) v2

Pro

Connect AI assistants to your Noverload knowledge base with advanced v2 features. Token management, enhanced search, and content synthesis for superior AI workflows.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources. With Noverload's v2 MCP integration, you can:

  • Give AI assistants direct access to your saved content with token warnings
  • Search your knowledge base using multiple modes (smart, semantic, fulltext)
  • Reference specific saved items with automatic content enrichment
  • Generate actionable insights across your entire content library
  • Synthesize information from multiple sources with contradiction detection
  • Get token usage estimates before retrieving large content

Supported AI Assistants

Noverload's MCP server works with any MCP-compatible AI assistant:

Claude Desktop

Anthropic's official desktop app with native MCP support

Cursor

AI-powered code editor with MCP integration

Windsurf

Next-gen AI coding assistant with MCP support

Installation

Recommended: Zero-Install Configuration

No installation needed! Just copy this configuration and replace your-token-here with your actual token:

{
"mcpServers": {
  "noverload": {
    "command": "npx",
    "args": ["-y", "noverload-mcp@latest"],
    "env": {
      "NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
    }
  }
}
}

✨ Why this works: NPX automatically downloads and runs the latest version of noverload-mcp. No manual installation or updates needed!

Alternative Installation Methods

View alternative installation options →

Option 2: Global Install

Install once, run directly (faster startup):
First install globally:
npm install -g noverload-mcp
Then use this config:
{
"mcpServers": {
  "noverload": {
    "command": "noverload-mcp",
    "args": [],
    "env": {
      "NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
    }
  }
}
}

Option 3: Specific Version

Pin to a specific version for stability:
{
"mcpServers": {
  "noverload": {
    "command": "npx",
    "args": ["-y", "noverload-mcp@0.5.0"],
    "env": {
      "NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
    }
  }
}
}

Quick Setup Guide

1

Generate Your Personal Access Token

  1. 1. Go to Dashboard Settings
  2. 2. Find "Personal Access Tokens" section
  3. 3. Click "New Token" and name it (e.g., "Claude MCP")
  4. 4. Copy your token immediately (it won't be shown again)

💡 Tip: Store your token in a password manager for safekeeping.

2

Add to Your AI Assistant

Replace your-token-here with your actual token in the configuration below:

Complete Configuration (Zero-Install)
{
"mcpServers": {
  "noverload": {
    "command": "npx",
    "args": ["-y", "noverload-mcp@latest"],
    "env": {
      "NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
    }
  }
}
}
Where to add this configuration:
Claude Desktop
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Cursor

Settings → Features → Model Context Protocol → Add Configuration

Windsurf

Settings → MCP Configuration → Add Server

Verify Connection

  1. Restart your AI assistant completely
  2. Look for "noverload" in the MCP tools or context menu
  3. Try asking: "What content have I saved in Noverload?"

✅ Success: You should see your saved content listed!

Available MCP Tools

The Noverload MCP server v2 provides powerful tools for AI assistants to interact with your saved content:

search_content

Advanced search with multiple modes and smart filtering

{
"query": "productivity tips",
"searchMode": "smart",
"limit": 10,
"tags": ["productivity"],
"includeFullContent": false
}

get_content_details

Get complete details including transcript, summary, and insights

{
"contentId": "clm3n4k5p0001..."
}

list_saved_content

List your saved content with filtering options

{
"contentType": "youtube",
"status": "completed",
"limit": 20
}

list_actions

View action items extracted from your content

{
"completed": false,
"goalId": "health"
}

synthesize_content

Generate insights across multiple content sources

{
"query": "marketing strategies",
"synthesisMode": "actionable",
"findContradictions": true
}

estimate_search_tokens

Estimate token usage before retrieving content

{
"query": "AI tools",
"limit": 5
}

Example Use Cases

Research Assistant

"Search my saved content about machine learning and summarize the key concepts"

Claude will search your Noverload library and synthesize information from multiple sources.

Action Item Review

"What action items have I saved related to marketing strategies?"

Retrieve and organize action items extracted from your marketing content.

Content Analysis

"Analyze the productivity videos I've saved and identify common themes"

Cross-reference multiple pieces of content to find patterns and insights.

What's New in v2

Security & Privacy

Your data security is our priority. The MCP integration includes:

  • Token-based authentication - Secure API tokens with revocation support
  • Encrypted connections - All data transmitted over HTTPS
  • Scoped access - Tokens only access your own content
  • Audit logging - Track all API access in your dashboard
  • Rate limiting - Prevent abuse and ensure fair usage

Troubleshooting

⚠️ Token Warnings

With v2, you may see warnings when retrieving large content (>10,000 tokens). This is a safety feature to prevent context overflow.

Solution: Use includeFullContent: false for searches, or retrieve specific sections of large documents.

Server not appearing in Claude

Ensure your configuration file is properly formatted and saved in the correct location. Restart Claude Desktop after making changes.

Windows: Make sure Node.js is in your system PATH
macOS/Linux: Check file permissions on the config file

npx command not found

Install Node.js from

nodejs.org

which includes npm and npx.

Verify installation: node --version and npx --version

Authentication errors

Verify your API token is correct and hasn't been revoked. Generate a new token if needed from your dashboard settings.

No results returned

Check that you have saved and processed content in your Noverload account. Content must be fully processed to appear in search results.

Ready to connect your AI assistant?

Upgrade to Pro to enable MCP integration and supercharge your AI conversations with your personal knowledge base.

By Noverload Team
Last updated: 1/31/2025