Acornonaut MCP Server

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`:

{
  "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`:

{
  "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:

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

Continue.dev / Cline

Add to your MCP config:

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

OpenClaw

{
  "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

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 file.

Built with ❤️ by the Acornonaut team