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

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

---

Built with ❤️ by the Acornonaut team