Acornonaut MCP Server
AI-powered YouTube to flashcards with spaced repetition and Anki export
Open source Repository Open in the app JSON README (API)
About
AI-powered YouTube to flashcards with spaced repetition and Anki export
Details
- Kind
- MCP servers
- Topic
- Social & content
- Publisher
- zerolve-io
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 2.5.5
- Open pull requests
- 1
- Last push
- 2026-08-27T19:46:38Z
- Repository state
- ativo
- Language
- Dockerfile
- License
- MIT
- Added
- 2026-08-29 04:01:43
- Updated
- 2026-08-29 04:01:43
- Origin id
io.github.zerolve-io/acornonaut
README
# Acornonaut MCP Server
[](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](LICENSE) file.
---
**Built with** ❤️ **by the Acornonaut team**