Anki Cards (Clanki)

by jasperket

9 stars
Not rated
GitHub

About

Integrates with Anki flashcards to provide card creation and deck management capabilities.

Details

Author
jasperket
Repository
jasperket/clanki
GitHub stars
9
License
MIT License
Categories
Productivity, Other, Knowledge Base, AI, Developer Tools

- Create and manage Anki decks
- Create basic flashcards with front/back content
- Create cloze deletion cards
- Update existing cards and cloze deletions
- Add and manage tags
- View deck contents and card information
- Full integration with AnkiConnect

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Anki Cards (Clanki)
    Command (node, npx, python, etc.) node
    Arguments
    • Argument 1 /absolute/path/to/clanki/build/index.js

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Make sure Anki is running and the AnkiConnect plugin is installed and enabled

2. Configure Claude for Desktop to use the server by editing claude_desktop_config.json:

{
  "mcpServers": {
    "clanki": {
      "command": "node",
      "args": ["/absolute/path/to/clanki/build/index.js"]
    }
  }
}

Replace /absolute/path/to/clanki with the actual path to your clanki installation.

create-deck

Creates a new Anki deck. Parameters: name (string) - Name for the new deck.

create-card

Creates a new basic flashcard in a specified deck. Parameters: deckName (string) - Name of the deck to add the card to, front (string) - Front side content of the card, back (string) - Back side content of the card, tags (optional array) - Array of tags for the card.

create-cloze-card

Creates a new cloze deletion card in a specified deck. Parameters: deckName (string) - Name of the deck to add the card to, text (string) - Text containing cloze deletions using {{c1::text}} syntax, backExtra (optional string) - Extra information to show on the back of the card, tags (optional array) - Array of tags for the card.

update-card

Updates an existing basic flashcard. Parameters: noteId (string) - ID of the note to update, front (optional string) - New front side content, back (optional string) - New back side content, tags (optional array) - New tags for the card.

update-cloze-card

Updates an existing cloze deletion card. Parameters: noteId (string) - ID of the note to update, text (optional string) - New text with cloze deletions, backExtra (optional string) - New extra information for the back, tags (optional array) - New tags for the card.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "anki cards (clanki)": {
            "cwd": "string",
            "env": {},
            "args": [
                "/absolute/path/to/clanki/build/index.js"
            ],
            "shell": false,
            "command": "node"
        }
    }
}

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "/absolute/path/to/clanki/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "/absolute/path/to/clanki/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "/absolute/path/to/clanki/build/index.js"
    ],
    "shell": false,
    "command": "node"
}

MseeP.ai Security Assessment Badge
License: MIT

Clanki - Claude's Anki Integration

An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks through the Model Context Protocol (MCP).

Features

- Create and manage Anki decks
- Create basic flashcards with front/back content
- Create cloze deletion cards
- Update existing cards and cloze deletions
- Add and manage tags
- View deck contents and card information
- Full integration with AnkiConnect

Prerequisites

- Anki installed and running
- AnkiConnect plugin installed in Anki
- Node.js 16 or higher

Installation

1. Clone this repository:

git clone https://github.com/yourusername/clanki.git
cd clanki

2. Install dependencies:

npm install

3. Build the project:

npm run build

Setup

1. Make sure Anki is running and the AnkiConnect plugin is installed and enabled

2. Configure Claude for Desktop to use the server by editing claude_desktop_config.json:

{
  "mcpServers": {
    "clanki": {
      "command": "node",
      "args": ["/absolute/path/to/clanki/build/index.js"]
    }
  }
}

Replace /absolute/path/to/clanki with the actual path to your clanki installation.

Available Tools

create-deck

Creates a new Anki deck

- Parameters:
- name: Name for the new deck

create-card

Creates a new basic flashcard in a specified deck

- Parameters:
- deckName: Name of the deck to add the card to
- front: Front side content of the card
- back: Back side content of the card
- tags: (Optional) Array of tags for the card

create-cloze-card

Creates a new cloze deletion card in a specified deck

- Parameters:
- deckName: Name of the deck to add the card to
- text: Text containing cloze deletions using {{c1::text}} syntax
- backExtra: (Optional) Extra information to show on the back of the card
- tags: (Optional) Array of tags for the card

update-card

Updates an existing basic flashcard

- Parameters:
- noteId: ID of the note to update
- front: (Optional) New front side content
- back: (Optional) New back side content
- tags: (Optional) New tags for the card

update-cloze-card

Updates an existing cloze deletion card

- Parameters:
- noteId: ID of the note to update
- text: (Optional) New text with cloze deletions
- backExtra: (Optional) New extra information for the back
- tags: (Optional) New tags for the card

Development

To modify or extend the server:

1. Make changes to src/index.ts
2. Rebuild with npm run build
3. Debug with npx @modelcontextprotocol/inspector node build/index.js

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

- Built with the Model Context Protocol SDK
- Integrates with Anki via AnkiConnect

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.