How to Use the Weblate MCP in Windsurf

Q: How do I check general Weblate usage with Windsurf?

You can run getlanguagestatistics to pull global data on any language definition. This gives you an immediate high-level view of the entire localization effort.

Q: Can Windsurf handle large project data exports?

Yes. Use the getprojectfileurl tool; it retrieves the URL necessary to download all translations for a whole project as a single ZIP archive, which is exactly what you're looking for.

Q: What if I need to update a user's details using Weblate and Windsurf?

You simply call updateuser with the required fields. This method handles updating existing user information without needing to delete and recreate their account.

Automate your entire translation lifecycle with Weblate using Windsurf's autonomous agent.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Weblate MCP to Windsurf

Create your Vinkius account to connect Weblate to Windsurf 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 Weblate with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage Projects and Languages

Need to set up a new localization effort? You can run `create_project` to define the main project container. It also handles language definition, letting you use `create_language` to establish new definitions like plural formulas or aliases for that specific locale. This allows your agent to build out the entire necessary structure—from initial setup through component creation (`create_project_component`)—without you having to prompt every single step.

Administer Users and Roles

The Windsurf MCP Server manages team access. You can use `create_user` to onboard a new contributor or `delete_user` if someone leaves the group. Furthermore, it handles permissions: call `add_group_admins` to assign top-level roles or `create_role` to set up granular permission sets. It's perfect for initial setup scripts; the agent figures out who needs what access and executes the changes automatically.

Retrieve Project Metrics

See how far along a translation is? Call `get_language_statistics` to get global metrics for any language. You can also use `list_project_languages` to pull paginated statistics across all languages within a single project. This data gives you a clear picture of team contribution velocity, letting you report progress without manually querying multiple endpoints.

Setup guide

Set up Weblate MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Weblate MCP

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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Weblate payment history." If connected, Cascade will call the Weblate tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "weblate-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 Weblate. 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 Weblate 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 Weblate MCP in Windsurf

You can run `get_language_statistics` to pull global data on any language definition. This gives you an immediate high-level view of the entire localization effort.

It exposes full administrative control over user and group management. You can manage everything from creating roles (`create_role`) to listing all users via `list_users`.

Yes. Use the `get_project_file_url` tool; it retrieves the URL necessary to download all translations for a whole project as a single ZIP archive, which is exactly what you're looking for.

This server touches Projects, Components, Groups, Roles, Users, and Language definitions. If it exists in the Weblate UI, your agent can probably act on it.

You simply call `update_user` with the required fields. This method handles updating existing user information without needing to delete and recreate their account.

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