# Resurgo MCP Server
Official MCP (Model Context Protocol) server for [Resurgo](https://resurgo.app) - your ideas rise again.
## What is Resurgo?
Resurgo helps you capture important information (URLs, notes, ideas) and **forces** them to resurface at scheduled times - via email digests, browser new tab override, and AI assistant integration. Never lose track of what matters.
## Installation
```bash
npm install resurgo-mcp
# or
pnpm add resurgo-mcp
```
## Quick Start
### Get Your API Key
1. Log in to [Resurgo](https://resurgo.app)
2. Go to **Settings → API**
3. Click **Create API Key**
4. Copy your key
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"resurgo": {
"command": "npx",
"args": ["resurgo-mcp"],
"env": {
"RESURGO_API_KEY": "your_api_key_here"
}
}
}
}
```
**Optional:** Override the API URL (for self-hosted instances):
```json
{
"mcpServers": {
"resurgo": {
"command": "npx",
"args": ["resurgo-mcp"],
"env": {
"RESURGO_API_KEY": "your_api_key_here",
"RESURGO_API_URL": "https://your-instance.com/api"
}
}
}
}
```
## Available Tools
The MCP server provides 5 tools for managing your knowledge:
### 1. search_nodes
Search your saved items with full-text search and filters.
```typescript
{
query: string; // Search term
tags?: string[]; // Filter by tags
status?: 'active' | 'parked' | 'done' | 'archived';
limit?: number; // Max results (default: 20)
}
```
**Example:**
> "Search my Resurgo nodes for 'react hooks' with the tag 'development'"
### 2. get_due_items
Get items that are due for review today (your inbox).
```typescript
{
includeOverdue?: boolean; // Include overdue items (default: true)
}
```
**Example:**
> "Show me what's due in my Resurgo inbox today"
### 3. quick_capture
Save a new item with optional scheduling.
```typescript
{
title: string; // Item title
note?: string; // Optional notes
url?: string; // Optional URL
tags?: string[]; // Tags for organization
resurfaceIn?: string; // When to resurface (see below)
}
```
**Scheduling options:**
- `"tomorrow"` - Resurface tomorrow at 9am
- `"next week"` or `"1 week"` - In 7 days
- `"2 weeks"` - In 14 days
- `"next month"` or `"1 month"` - In 30 days
- `"2025-06-15"` - Specific ISO date
**Example:**
> "Save this URL to Resurgo: https://react.dev/learn with the note 'Review new hooks API' and resurface next week"
### 4. snooze_node
Defer an item to resurface later.
```typescript
{
nodeId: string; // Item UUID
until: string; // When to resurface (same format as quick_capture)
}
```
**Example:**
> "Snooze this Resurgo item until tomorrow"
### 5. complete_node
Mark an item as done.
```typescript
{
nodeId: string; // Item UUID
}
```
**Example:**
> "Mark this Resurgo item as complete"
## How It Works
The MCP server connects to your Resurgo account via API and provides AI assistants like Claude with tools to:
- **Search** through your saved knowledge
- **Capture** new items during conversations
- **Schedule** when items should resurface
- **Manage** your inbox (snooze, complete, etc.)
This means you can have natural conversations like:
> "Search my Resurgo notes about TypeScript patterns and create a new note summarizing the key points to review next week"
The AI will use the MCP tools to search, synthesize the information, and create a scheduled note automatically.
## Use Cases
- **Research Management**: Save articles, papers, and links during research sessions
- **Learning**: Schedule spaced repetition for concepts you're learning
- **Project Planning**: Capture ideas and schedule them for review at the right time
- **Meeting Notes**: Save action items and have them resurface before deadlines
- **Reading List**: Never lose track of articles you want to read
## Requirements
- Node.js 20+
- Active Resurgo account ([sign up](https://resurgo.app))
- Resurgo API key ([create one](https://resurgo.app/home/settings/api))
- MCP-compatible AI assistant (Claude Desktop, etc.)
## Support
- **Issues**: [GitHub Issues](https://github.com/code-atlantic/resurgo/issues)
## Privacy & Security
- **API Key Authentication**: Secure token-based access
- **Scoped Access**: API keys are tied to your account and can be revoked anytime
- **HTTPS Only**: All communication encrypted in transit
## License
MIT License - see [LICENSE](LICENSE) for details
---
Made with ❤️ by [Code Atlantic](https://code-atlantic.com)
