# Acornonaut MCP Server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/zerolve-io/acornonaut-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/acornonaut-mcp-server

## Description
AI-powered YouTube to flashcards with spaced repetition and Anki export

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "acornonaut-mcp-server": {
    "url": "https://img.shields.io/badge/MCP-compatible-green)](https://modelcontextprotocol.io"
  }
}
```

## Documentation & README

# Acornonaut MCP Server

[![MCP](https://img.shields.io/badge/MCP-compatible-green)](https://modelcontextprotocol.io)

**AI-powered flashcard generation from YouTube videos** — Turn any YouTube playlist into spaced-repetition flashcards and manage your learning library through any MCP-compatible AI client.

This is the official MCP server for Acornonaut, hosted at `https://mcp.acornonaut.app`.

## ✨ Features

- 🎥 **YouTube to flashcards** — AI-generated cards from video transcripts
- 🧠 **Spaced repetition** — SM-2 algorithm for optimal review scheduling
- 📚 **Playlist management** — Organize learning content by topic
- 🔍 **Semantic search** — Find cards across your entire library
- 📦 **Anki export** — Export decks to Anki format
- 🔐 **OAuth 2.0** — Secure, browser-based authentication

## 🚀 Quick Start

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "acornonaut": {
      "url": "https://mcp.acornonaut.app"
    }
  }
}
```

Restart Claude Desktop. On first use, your browser will open for OAuth sign-in.

### Cursor

Add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "acornonaut": {
      "url": "https://mcp.acornonaut.app",
      "transport": "streamable-http"
    }
  }
}
```

### Windsurf

Use MCP Server settings:

- **Name:** `acornonaut`
- **URL:** `https://mcp.acornonaut.app`
- **Transport:** `streamable-http`

Or JSON config:

```json
{
  "mcpServers": {
    "acornonaut": {
      "url": "https://mcp.acornonaut.app",
      "transport": "streamable-http"
    }
  }
}
```

### Continue.dev / Cline

Add to your MCP config:

```json
{
  "mcpServers": {
    "acornonaut": {
      "url": "https://mcp.acornonaut.app"
    }
  }
}
```

### OpenClaw

```json
{
  "mcpServers": {
    "acornonaut": {
      "url": "https://mcp.acornonaut.app"
    }
  }
}
```

## 🔐 Authentication

Acornonaut MCP uses **OAuth 2.0** for secure authentication:

1. On first connection, your browser opens automatically
2. Sign in to Acornonaut (or create a free account)
3. Grant MCP access
4. Return to your AI client — you're connected!

**No API keys to manage.** Tokens are stored securely by your MCP client.

## 🛠️ Available Tools

| Tool | Description |
|------|-------------|
| **Playlists** |
| `list_playlists` | List all your playlists with status and progress |
| `get_playlist` | Get a single playlist with videos and cards |
| `create_playlist` | Create a new playlist from a YouTube URL |
| `update_playlist` | Rename or update playlist settings |
| `delete_playlist` | Permanently delete a playlist and its cards |
| **Videos** |
| `add_video_by_url` | Add a single YouTube video to a playlist |
| `get_video_cards` | Get all flashcards for a specific video |
| `get_transcript` | Retrieve the full transcript of a video |
| **Cards** |
| `list_cards` | List paginated flashcards with filters |
| `get_card` | Get a single card by ID |
| `create_card` | Create a custom flashcard manually |
| `update_card` | Edit a card's front, back, or metadata |
| `delete_card` | Delete a specific card |
| `search_cards` | Full-text search across all your cards |
| **Spaced Repetition** |
| `review_due_cards` | Get cards due for review today |
| `answer_card` | Submit review answer and update scheduling |
| `get_review_stats` | View your review statistics and streaks |

**Total:** 18 tools

## 📖 Example Usage

### Create a playlist from YouTube

```
Ask your AI: "Create an Acornonaut playlist from https://www.youtube.com/playlist?list=..."
```

### Search your flashcards

```
Ask your AI: "Search my Acornonaut cards for 'photosynthesis'"
```

### Review due cards

```
Ask your AI: "What cards are due for review in Acornonaut today?"
```

### Export to Anki

```
Ask your AI: "Export my 'Biology 101' playlist from Acornonaut as an Anki deck"
```

## 🔗 Links

- **Product:** https://acornonaut.app
- **Documentation:** https://acornonaut.app/docs/mcp
- **Main repository:** https://github.com/zerolve-io/coursecards
- **MCP Spec:** https://modelcontextprotocol.io

## 📝 License

MIT License - see [LICENSE](https://github.com/zerolve-io/acornonaut-mcp/blob/HEAD/LICENSE) file.

---

**Built with** ❤️ **by the Acornonaut team**