How to Use the Duolingo MCP in Claude

Q: How do I configure the Duolingo tools inside Claude Desktop?

You edit your local claudedesktopconfig.json file to register the server. Once saved, fully restart Claude Desktop to see the tools appear in your chat window.

Track your Duolingo learning progress and fetch translation hints directly inside Claude Desktop.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Duolingo MCP to Claude Desktop

Create your Vinkius account to connect Duolingo to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Duolingo with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Monitor Progress with the Duolingo MCP Server

The `get_user_by_username` tool pulls raw Duolingo profile metrics directly into your Claude Desktop chat window. You get immediate access to streak counts, total XP, and active languages without opening a browser tab. If you need to check a classmate or study partner, `get_user_by_id` fetches the exact same profile data using their numeric ID. This lets your agent analyze learning velocity and build custom progress summaries on the fly.

Build Flashcards and Study Guides

The `get_dictionary_hints` tool gets translation pairs for vocabulary tokens across multiple language codes. Your Claude Desktop MCP client uses this raw data to generate contextual flashcards and grammar drills based on real Duolingo vocabulary. You can also run `get_version_info` to check which language codes are supported before starting a study session. This keeps your custom study guides accurate and prevents translation errors during automated review generation.

Track Leaderboards and Friend Activity

The `get_daily_leaderboard` tool extracts the top users by XP for the current day to show how you stack up against the competition. Claude Desktop can format this raw data into a clean, readable leaderboard directly in your sidebar. To check on your immediate study circle, `get_friends` pulls usernames, streaks, and XP totals for your entire network. You can also run `get_leaderboard` for specific users to see exactly where they stand in their weekly tiers.

Setup guide

Set up Duolingo MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Duolingo MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Duolingo MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under duolingo-mcp.

json

{
  "mcpServers": {
    "duolingo-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Duolingo. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Duolingo now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Duolingo MCP in Claude Desktop

You edit your local `claude_desktop_config.json` file to register the server. Once saved, fully restart Claude Desktop to see the tools appear in your chat window.

Yes, but only if you provide your account token during setup. Without authentication, Claude Desktop only reads public metrics like your current streak and XP.

You can use the web interface by adding the MCP server as a custom connector. This lets you run the same queries without running a local background process.

The server might return errors or missing fields if the underlying endpoints shift. We update the server package regularly to match any changes in their web layout.

All requests run locally on your machine or through a secure sandbox that never stores your credentials. Your profile details, XP history, and streak data are transmitted directly to your agent and are never cached on third-party servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript