Model Context Protocol (MCP)

Pro

Connect AI assistants like Claude, Cursor, and Windsurf to your Noverload knowledge base with the Model Context Protocol.

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 MCP integration, you can:

  • Give AI assistants direct access to your saved content
  • Search your knowledge base using semantic search
  • Reference specific saved items with full transcripts and summaries
  • Explore topics and synthesize insights across your entire library
  • Extract frameworks and step-by-step processes from your saved content
  • Save new content directly from your AI assistant

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

Step 1: Install Node.js

Node.js is a free program that runs the MCP server on your computer. If you already have it installed, skip to Step 2.

1
Download the installer

Go to nodejs.org and click the green "Download" button. It will automatically detect your operating system (Mac, Windows, or Linux).

2
Run the installer

Open the downloaded file and follow the prompts. Click "Next" or "Continue" through each screen — the default settings are fine. No need to change anything.

3
Restart your computer

After installing, restart your computer so the npx command becomes available to your AI tools.

Step 2: Get Your Configuration

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://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://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://noverload.com\",\"readOnly\":true}"
    }
  }
}
}

Step 3: Create Your Access Token

1

Generate Your Personal Access Token

  1. 1. Go to Dashboard Settings
  2. 2. Scroll down to the "Personal Access Tokens" section
  3. 3. Click "New Token" and give it a name (e.g., "Claude MCP")
  4. 4. Copy your token immediately — it won't be shown again
  5. 5. We'll also show you the ready-to-paste config for your AI tool

💡 Tip: When you create a token, we generate the complete config for you. Just copy and paste — no manual editing needed.

2

Add to Your AI Assistant

After creating your token, copy the config and paste it into your AI tool. Here's how for each tool:

Claude Desktop
  1. Open Claude Desktop on your computer
  2. Click Claude in the top menu bar, then click Settings
  3. Click Developer in the left sidebar
  4. Click Edit Config — this opens a text file
  5. Select all the text in that file and replace it with the config you copied
  6. Save the file (Ctrl+S on Windows, Cmd+S on Mac)
  7. Fully quit Claude Desktop and reopen it
Cursor
  1. Open Cursor on your computer
  2. Click the gear icon (Settings), then click Cursor Settings
  3. Type "MCP" in the search bar at the top
  4. Click Add new global MCP server
  5. Paste the config you copied into the file that opens
  6. Save the file and restart Cursor
Windsurf
  1. Open Windsurf on your computer
  2. Go to Settings, then MCP Configuration
  3. Click Add Server
  4. Paste the config you copied
  5. Save and restart Windsurf

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

Your AI assistant gets access to 9 tools for interacting with your saved content:

search_content

Search saved content by topic, keyword, or concept. Supports semantic, hybrid, and full-text search.

"Find my saved content about productivity"

get_content_details

Get full details of a specific item — summary, key insights, tags, and optionally the full transcript or article text.

"Show me the full summary of that React video"

list_saved_content

Browse your saved content with optional filters by type or status.

"What YouTube videos have I saved?"

explore_topic

Synthesize insights about a topic across multiple saved sources. Finds themes, connections, and knowledge gaps.

"What have I learned about marketing?"

extract_frameworks

Extract step-by-step processes and repeatable methods from your saved content.

"What frameworks exist for building habits?"

batch_get_content

Fetch multiple content items by ID in one request. Use after searching to retrieve several items at once.

"Get the full text of those 3 articles"

save_content

Save a new URL to Noverload directly from your AI assistant.

"Save this article: https://example.com/post"

list_goals

View your goals to connect saved content with what you're working toward.

"What goals do I have set up?"

list_tags

See all your tags for organizing and filtering content.

"What tags do I have?"

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.

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

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: 2/14/2026