# Vocabit

> Vocabit is an open-source MCP server. Create flashcard sets in the Vocabit app and read back how the learner actually did. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Repository:** https://github.com/johnbilousov/vocabit-mcp
- **MCP Registry name:** io.github.JohnBilousov/vocabit-mcp
- **Listing updated:** 2026-11-13

## About

Create flashcard sets in the Vocabit app and read back how the learner actually did.

## Install

### Claude Code (Terminal)

```sh
claude mcp add vocabit-mcp --env VOCABIT_AGENT_KEY='<VOCABIT_AGENT_KEY>' -- npx -y vocabit-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vocabit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vocabit-mcp"
      ],
      "env": {
        "VOCABIT_AGENT_KEY": "<VOCABIT_AGENT_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vocabit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vocabit-mcp"
      ],
      "env": {
        "VOCABIT_AGENT_KEY": "<VOCABIT_AGENT_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vocabit-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vocabit-mcp"
      ],
      "env": {
        "VOCABIT_AGENT_KEY": "<VOCABIT_AGENT_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vocabit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vocabit-mcp"
      ],
      "env": {
        "VOCABIT_AGENT_KEY": "<VOCABIT_AGENT_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vocabit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "vocabit-mcp"
      ],
      "env": {
        "VOCABIT_AGENT_KEY": "<VOCABIT_AGENT_KEY>"
      }
    }
  }
}
```

## FAQ

### Is Vocabit free?

Yes. Vocabit is open source, so you can use and self-host it for free.

### How do I add Vocabit to Claude Code?

Run this command in your terminal: claude mcp add vocabit-mcp --env VOCABIT_AGENT_KEY='<VOCABIT_AGENT_KEY>' -- npx -y vocabit-mcp

---
Source: https://ai-powered.com/mcp/vocabit
