# Weblate MCP by usefulapi

> Weblate MCP by usefulapi is an MCP server. Read Weblate projects, strings, stats and changes; translate, suggest, comment and autotranslate. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/weblate/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/weblate
- **MCP Registry name:** io.usefulapi/weblate
- **Listing updated:** 2026-11-13

## About

Read Weblate projects, strings, stats and changes; translate, suggest, comment and autotranslate.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http weblate https://weblate.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://weblate.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "weblate": {
      "url": "https://weblate.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "weblate": {
      "type": "http",
      "url": "https://weblate.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "weblate": {
      "serverUrl": "https://weblate.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "weblate": {
      "type": "http",
      "url": "https://weblate.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `weblate_list_projects`: List the projects visible to this token: name, slug, website and settings (review workflow, access control). GET /api/projects/.
- `weblate_get_project`: One project by slug: name, website, settings, instructions and links. GET /api/projects/{project}/.
- `weblate_list_components`: List translation components (one translatable file set in a repository), with repository, file mask, source language and status flags. Give a project to list only its components. Repository URLs have embedded credentials removed. GET /api/components/ or /api/projects/{project}/components/.
- `weblate_get_component`: One component: repository, branch, file mask, template, source language, commit and merge settings, lock state. GET /api/components/{project}/{component}/.
- `weblate_list_translations`: List the translations (one language each) of a component with their statistics: total, translated, fuzzy, percent, last change. GET /api/components/{project}/{component}/translations/.
- `weblate_get_translation`: One translation (a component in one language): statistics, language, file name, revision and links. GET /api/translations/{project}/{component}/{language}/.
- `weblate_get_statistics`: Translation progress: strings and words total, translated, needing edit, with percentages and checks. Scope by project; add a component for per-language statistics of a component, add a language too for one translation. GET /api/projects/{project}/statistics/, /api/components/{project}/{component}/statistics/ or /api/translations/{project}/{component}/{language}/statistics/.
- `weblate_list_project_languages`: Per-language translation statistics for a whole project (code, total, translated, percentages). GET /api/projects/{project}/languages/.
- `weblate_list_languages`: List the languages known to this Weblate instance: code, name, text direction, plural forms. GET /api/languages/.
- `weblate_list_units`: List or search translation strings (units): source, target, state (0 untranslated, 10 needs editing, 20 translated, 30 approved, 100 read-only), context, location, failing checks. Search with Weblate's query syntax, for example state:<translated or has:suggestion. Give project + component + language to read one translation; without them all visible strings are searched. GET /api/translations/{proj
- `weblate_get_unit`: One string by id: source and target forms, state, context, location, flags, labels, explanation, suggestions/comments flags, web link. GET /api/units/{id}/.
- `weblate_list_unit_comments`: Comments on one string (Weblate 5.15+). GET /api/units/{id}/comments/.
- `weblate_list_suggestions`: List suggestions (proposed translations waiting for review), newest first (Weblate 2026.8+). Give a unit id for one string's suggestions. GET /api/suggestions/ or /api/units/{id}/suggestions/.
- `weblate_list_changes`: The activity log: who changed or translated what, when, with the action name and the changed text. Scope by project, component or translation (language), or filter by user, action id and time range. GET /api/changes/ or the project/component/translation changes endpoint.
- `weblate_search_memory`: Browse the translation memory entries visible to the token, filtered by source text (substring), languages or project. GET /api/memory/.
- `weblate_lookup_memory`: Find translation memory matches (exact or fuzzy) for up to 20 source strings in one language pair. Read-only: nothing is stored. POST /api/memory/lookup/.
- `weblate_get_repository_status`: Version-control status: pending changes to commit, upstream changes to merge, changes to push, remote commit, merge failure. For a project (summary of all its repositories) or one component. GET /api/projects/{project}/repository/ or /api/components/{project}/{component}/repository/.
- `weblate_update_translation`: WRITE: set the translation of one string (replaces the current target). `target` is the list of plural forms. `state` is required (Weblate rejects a partial update without both): 0 untranslated with an empty target, 10 needs editing, 20 translated or 30 approved (approval needs the review workflow and permission). The number of plural forms must match the language. Changes are committed to the rep
- `weblate_add_suggestion`: WRITE: propose a translation for one string; normally a reviewer accepts it later, but the author's automatic upvote (or an existing identical suggestion) can reach the project's auto-accept threshold and apply it at once. Needs the Add suggestion permission and suggestions enabled (Weblate 2026.8+). POST /api/units/{id}/suggestions/.
- `weblate_accept_suggestion`: WRITE: apply a suggestion to its string (replaces the current translation). `approve` also marks it approved (review workflow and permission needed). Weblate 2026.8+. POST /api/suggestions/{id}/accept/.
- `weblate_add_unit_comment`: WRITE: add a comment to one string (Markdown, @username mentions notify users). `scope` is global (all languages), translation (this language) or report (a source-string issue report; needs the review workflow). Weblate 5.12+. POST /api/units/{id}/comments/.
- `weblate_repository_operation`: WRITE: commit (write pending translations into the local repository), pull (merge upstream changes) or push (publish committed changes to the remote repository) for a project or one component. Push changes the remote repository. reset and cleanup are not offered. POST /api/projects/{project}/repository/ or /api/components/{project}/{component}/repository/.
- `weblate_autotranslate`: WRITE: fill a translation automatically from other components (auto_source others, default) or from machine translation (mt, needs engines). `mode` suggest only adds suggestions (default), translate writes translations, fuzzy marks them needing edit. `q` limits it to strings matching a search (default state:<translated, the strings that are not translated yet); threshold is the minimum match score

## FAQ

### How do I add Weblate MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http weblate https://weblate.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/weblate-mcp-by-usefulapi
