# Duolingo MCP

> Duolingo MCP is an open-source MCP server for learning resources. Keyless MCP server that reads public Duolingo profile data: languages, XP, streaks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted
- **Repository:** https://github.com/mrfentmen/awesome-mcps
- **MCP Registry name:** io.github.mrfentmen/duolingo-mcp
- **Categories:** [learning resources](https://ai-powered.com/categories/learning-resources)
- **Listing updated:** 2026-11-19

## About

The package exposes a Duolingo profile through the Model Context Protocol, so an MCP client can pull a learner's languages, XP totals, streak length and achievements without any API key. The registry entry describes it as a keyless server that runs over stdio and is installed from npm as duolingo-mcp.

It is a read-only lookup of profile information rather than a way to practise lessons or change anything on a Duolingo account. The registry entry lists no environment variables and no remote endpoints, so setup is a local npm package launched by the client.

It suits developers and learners who want to ask an AI assistant about their own or a friend's progress, or who are building MCP workflows that report on language-learning activity. The repository it is listed in is a broader collection of servers, and this listing covers only the Duolingo package.

## Features

- **Keyless profile lookup:** Reads Duolingo profile data without requiring an API key or account credentials, according to the registry entry.
- **Language and XP summary:** Returns the languages on a profile along with experience points.
- **Streak and achievement data:** Surfaces streak information and achievements from the profile.
- **stdio transport via npm:** Runs as a local stdio server installed from the npm package duolingo-mcp, version 1.0.0.

## Good for

- Asking an AI assistant how long a learner's current streak is
- Summarising which languages a profile is studying and their XP
- Reviewing achievements for a language-learning progress report
- Adding Duolingo progress lookups to an MCP-based personal dashboard

## Install

### Claude Code (Terminal)

```sh
claude mcp add duolingo-mcp -- npx -y duolingo-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "duolingo-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
```

## FAQ

### Does it require an API key?

No. The registry entry describes it as keyless and lists no environment variables.

### How is it installed?

The registry entry lists an npm package named duolingo-mcp at version 1.0.0, run over stdio.

### Does it remotely host the server?

No remote endpoints are listed in the registry entry; it runs locally via stdio.

### Is Duolingo MCP free?

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

### How do I add Duolingo MCP to Claude Code?

Run this command in your terminal: claude mcp add duolingo-mcp -- npx -y duolingo-mcp

### What are the best alternatives to Duolingo MCP?

The closest alternatives to Duolingo MCP are mcp-for-beginners, AI 與科技名詞白話解釋, IYT Test, Hi AI Tutor MCP and Kenoverse.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [mcp-for-beginners](https://ai-powered.com/mcp/mcp-for-beginners): mcp-for-beginners is an open-source MCP server for academic research.
- [AI 與科技名詞白話解釋](https://ai-powered.com/mcp/ai-11): AI 與科技名詞白話解釋 is an MCP server for learning resources.
- [IYT Test](https://ai-powered.com/mcp/iyt-test): IYT Test is an open-source MCP server for learning resources.
- [Hi AI Tutor MCP](https://ai-powered.com/mcp/hi-ai-tutor-mcp): Hi AI Tutor MCP is a freemium MCP server for learning resources.
- [Kenoverse](https://ai-powered.com/mcp/kenoverse): Kenoverse is an MCP server for learning resources.
- [LadderKit](https://ai-powered.com/mcp/ladderkit): LadderKit is an open-source MCP server for learning resources.
- [알잘 입시](https://ai-powered.com/mcp/listing-mwiuzcmf): 알잘 입시 is a free MCP server for learning resources.
- [Korean Special Education Learning Map MCP](https://ai-powered.com/mcp/korean-special-education-learning-map-mcp): Korean Special Education Learning Map MCP is an open-source MCP server for learning resources.

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