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:

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:

config.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:

config.json

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

Continue.dev / Cline

Add to your MCP config:

config.json

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

OpenClaw

config.json

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

🔐 Authentication

Acornonaut MCP uses OAuth 2.0 for secure authentication:

On first connection, your browser opens automatically
Sign in to Acornonaut (or create a free account)
Grant MCP access
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

Code

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

Search your flashcards

Code

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

Review due cards

Code

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

Export to Anki

Code

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