Skip to content
MCP server

Duolingo MCP

Keyless MCP server that reads public Duolingo profile data: languages, XP, streaks

Runs locally
Install
Pricing
Open source
Platforms
CLI, Self-hosted
Runs
Locally
Version
1.0.0
Listing updated
1 day ago

Similar MCP servers

About Duolingo MCP

Duolingo MCP is an open-source MCP server for learning resources. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add duolingo-mcp -- npx -y duolingo-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "duolingo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duolingo-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

What it does

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

Pricing

Open source

Free npm package; the repository source is listed alongside the server

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.

How AIPoweredBot checks servers