Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Duolingo with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Track language learning progress on Duolingo. view profiles, streaks, XP, leaderboards and dictionary hints.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 8 capabilities

The complete Duolingo capability set.

These are the exact actions your AI can choose when you ask it to work with Duolingo.

Capability set01 / 02

01-04

4 capabilities in this set.

Part of 8 available through Duolingo.

  1. 01

    Get daily leaderboard

    Shows top users by XP for the current day. Optionally specify language code and timezone. Get daily leaderboard for a language

  2. 02

    Get dictionary hints

    Returns translation pairs for the given tokens. Useful for building flashcards or vocabulary capabilities. Target and source are language codes (e.g. "es", "fr", "de", "en"). Get dictionary hints for word translations

  3. 03

    Get store items

    Requires authentication for full details. Returns item IDs, names, prices and descriptions. Get Duolingo store items

  4. 04

    Get friends

    Optionally provide a user ID. Returns friend usernames, IDs, streaks and XP totals. Get Duolingo friends list

Capability set02 / 02

05-08

4 capabilities in this set.

Part of 8 available through Duolingo.

  1. 05

    Get leaderboard

    Optionally provide a user ID to get leaderboard info for a specific user. Returns rankings with usernames, XP totals and positions. Get Duolingo leaderboard data

  2. 06

    Get user by ID

    Returns the same data as get_user_by_username but uses the numeric ID instead. Get a Duolingo user profile by user ID

  3. 07

    Get user by username

    Returns username, user ID, avatar, current language, total XP, streak, skills and progress. Note: Full profile data (detailed progress, skill trees) requires authentication and only works for your own account. Get a Duolingo user profile by username

  4. 08

    Get version info

    Useful for understanding available language codes and API capabilities. Get Duolingo API version information

Observed, not estimated

866ms average. Fast in production.

Duolingo is checked daily against the live service.

Daily averagePeak 1039ms
Aug 24Today
Fastest day
739ms
Slowest day
1039ms
14-day trend
Improving-20%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 8 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Duolingo, so you can see the experience inside your AI.

It does not authenticate your account with Duolingo. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Duolingo Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_bZJAGYPiuVrSCxUsIrFbawCKNsjHWAbf05lVgUFK/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Duolingo capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "duolingo-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_bZJAGYPiuVrSCxUsIrFbawCKNsjHWAbf05lVgUFK/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Duolingo owners ask.

  • 01

    Do I need a Duolingo account to use this?

    No! Public endpoints like user profiles, version info and dictionary hints work without authentication. Just provide a username to look up. For private data (your own progress, store items), you'd need to be logged into Duolingo.

  • 02

    What languages are supported?

    Duolingo supports 40+ languages including English, Spanish, French, German, Italian, Portuguese, Japanese, Korean, Chinese, Hindi and many more. Use get_version_info to see the full list of supported language codes.

  • 03

    Can I get my full learning progress?

    The public API returns limited profile data. For full progress including individual skill levels and detailed stats, you need to be authenticated with your Duolingo session. The username-based endpoint returns basic info like total XP, streak and current language.

  • 04

    Can I get translation hints for vocabulary?

    Yes! Use get_dictionary_hints with target and source language codes plus a list of words. It returns common translations for each word, useful for building flashcards or studying vocabulary.

Explore

More in Productivity

Suggestions