# Anki MCP Server

> Anki MCP Server to allow LLMs to create and manage Anki decks via Anki Connect

- **Type:** MCP server
- **Install:** `agentstack add mcp-ethangillani-anki-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ethangillani](https://agentstack.voostack.com/s/ethangillani)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ethangillani](https://github.com/ethangillani)
- **Source:** https://github.com/ethangillani/Anki-MCP-Server

## Install

```sh
agentstack add mcp-ethangillani-anki-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Anki MCP Server

A Model Context Protocol (MCP) server that enables LLMs to interact with Anki flashcard software through the AnkiConnect API.

## Features

- Create new decks in Anki
- Add notes to existing decks
- List available decks and note models
- Search for notes using Anki's search syntax
- Get detailed information about note models and their fields
- Bulk add multiple notes at once

## Prerequisites

- [Node.js](https://nodejs.org/) (v14 or later)
- [Anki](https://apps.ankiweb.net/) with the [AnkiConnect](https://ankiweb.net/shared/info/2055492159) add-on installed
- A Model Context Protocol compatible client (such as Claude with Anthropic MCP support)

## Installation

1. Make sure you have Anki installed with the AnkiConnect add-on
   - Install AnkiConnect by going to Tools > Add-ons > Get Add-ons and entering code: `2055492159`

2. Clone this repository:
   ```
   git clone https://github.com/yourusername/anki-mcp-server.git
   cd anki-mcp-server
   ```

3. Install dependencies:
   ```
   npm install
   ```

4. Build the project:
   ```
   npm run build
   ```

## Usage

1. Make sure Anki is running on your computer with AnkiConnect enabled

2. Start the MCP server:
   ```
   npm start
   ```

3. Connect your MCP client (e.g., Claude) to this server

## Available Tools

The server provides the following tools to MCP clients:

- **listDecks**: Get a list of all decks in Anki
- **listModels**: Get a list of all note models/types in Anki
- **createDeck**: Create a new deck in Anki
- **getModel**: Get details about a specific note model/type
- **addNote**: Add a single note to a deck
- **addNotes**: Add multiple notes at once
- **searchNotes**: Search for notes using Anki's search syntax

## Examples

### Create a New Deck

```json
{
  "name": "createDeck",
  "arguments": {
    "name": "My New Deck"
  }
}
```

### Add a Note

```json
{
  "name": "addNote",
  "arguments": {
    "deckName": "My New Deck",
    "modelName": "Basic",
    "fields": {
      "Front": "What is the capital of France?",
      "Back": "Paris"
    },
    "tags": ["geography", "europe"]
  }
}
```

### Search Notes

```json
{
  "name": "searchNotes",
  "arguments": {
    "query": "deck:\"My New Deck\" tag:geography"
  }
}
```

## Configuration

The server configuration is in the `config` object in `src/index.ts`. You can modify:

- `ankiConnectUrl`: URL for the AnkiConnect API (default: `http://localhost:8765`)
- `apiVersion`: API version for AnkiConnect (default: `6`)
- `defaultDeckName`: Default deck to use if none specified (default: `Default`)

## Troubleshooting

1. **Cannot connect to Anki**
   - Make sure Anki is running
   - Check that AnkiConnect add-on is installed and working
   - Verify that the AnkiConnect URL is correct (default: http://localhost:8765)

2. **Permission issues with AnkiConnect**
   - AnkiConnect may prompt for permission when the server tries to add cards. Look for a popup in Anki.

## License

MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ethangillani](https://github.com/ethangillani)
- **Source:** [ethangillani/Anki-MCP-Server](https://github.com/ethangillani/Anki-MCP-Server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ethangillani-anki-mcp-server
- Seller: https://agentstack.voostack.com/s/ethangillani
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.