Noverload MCP Server
Connect your Noverload saved content to AI assistants like Claude, Cursor, and Windsurf using the Model Context Protocol (MCP).
🚀 Now using Noverload API v2 for improved performance, token management, and enhanced search capabilities.
Quick Start
- Get your token: Generate a Personal Access Token from your Noverload dashboard
- Copy the config: Use the zero-install configuration below with your token
- Add to your AI tool: Paste into Claude Desktop, Cursor, or Windsurf settings
- Start using: Ask your AI about your saved content!
{
"mcpServers": {
"noverload": {
"command": "npx",
"args": ["-y", "noverload-mcp@latest"],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"your-token-here\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
}
}
}
}
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:
{
"command": "npx",
"args": ["-y", "noverload-mcp@latest"]
}
Alternative: Global Install
For faster startup (but requires manual updates):
npm install -g noverload-mcp
Then use:
{
"command": "noverload-mcp",
"args": []
}
For Development
git clone https://github.com/drewautomates/noverload-mcp.git
cd noverload-mcp
npm install
npm run build
Configuration
Step 1: Get Your Personal Access Token
- Log in to Noverload
- Go to Settings → API Access
- Click "Generate Personal Access Token"
- Copy the token (you won't be able to see it again)
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
{
"mcpServers": {
"noverload": {
"command": "npx",
"args": ["-y", "noverload-mcp@latest"],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"YOUR_ACCESS_TOKEN_HERE\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
}
}
}
}
Cursor
- Open Cursor Settings
- Navigate to Features → Model Context Protocol
- Add configuration:
{
"noverload": {
"command": "noverload-mcp",
"args": [],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"YOUR_ACCESS_TOKEN_HERE\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
}
}
}
Windsurf
Add to your Windsurf MCP configuration:
{
"mcpServers": {
"noverload": {
"command": "npx",
"args": ["-y", "noverload-mcp@latest"],
"env": {
"NOVERLOAD_CONFIG": "{\"accessToken\":\"YOUR_ACCESS_TOKEN_HERE\",\"apiUrl\":\"https://www.noverload.com\",\"readOnly\":true}"
}
}
}
}
Once configured, your AI assistant can:
Reading Content
list_saved_content - Browse your saved content libraryget_content_details - Get full details including summaries and insightssearch_content - Search through your content by keywordslist_actions - View action items extracted from contentlist_goals - See your Health, Wealth, and Relationships goals
Writing (when read-only is disabled)
save_content - Save new URLs to your Noverload librarycomplete_action - Mark action items as completed
Security Recommendations
- Use Read-Only Mode: Keep
readOnly: true in your configuration unless you specifically need write access - Protect Your Token: Never share your personal access token
- Revoke When Needed: You can revoke tokens anytime from Noverload settings
- 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
git clone https://github.com/yourusername/noverload-mcp.git
cd noverload-mcp
npm install
npm run build
# Run directly
node packages/mcp-server/dist/index.js '{"accessToken":"YOUR_TOKEN","readOnly":true}'
Option 2: Deploy to Your Infrastructure
The MCP server can be deployed to any Node.js hosting platform:
- Vercel/Netlify Functions: Deploy as a serverless function
- Docker Container: Package and run anywhere
- VPS: Run on your own server with PM2
Example Dockerfile:
FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --production
COPY dist ./dist
EXPOSE 3000
CMD ["node", "dist/index.js"]
Option 3: Private NPM Registry
Host on your own NPM registry for team distribution:
# Build the package
npm run build
# Publish to your registry
npm publish --registry https://your-registry.com
API Endpoints Required
For self-hosting, your Noverload API needs these endpoints:
GET /api/user - Validate access tokenGET /api/content - List saved contentGET /api/content/:id - Get content detailsPOST /api/content - Save new contentGET /api/content/search - Search contentGET /api/actions - List actionsPOST /api/actions/:id/complete - Complete actionGET /api/goals - List goals
Development
Project Structure
noverload-mcp/
├── packages/
│ ├── mcp-server/ # Main MCP server implementation
│ │ ├── src/
│ │ │ ├── index.ts # Entry point
│ │ │ ├── client.ts # Noverload API client
│ │ │ ├── tools/ # MCP tools (actions)
│ │ │ └── resources/ # MCP resources
│ │ └── package.json
│ └── mcp-utils/ # Shared utilities
└── package.json # Workspace root
Testing Locally
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
# Type check
npm run typecheck
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- 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
- Ensure the MCP server is properly configured
- Check your AI assistant's MCP logs
- Try reinstalling the package
License
MIT
Support