Provides seamless integration with Weblate translation management platform, enabling full API access to manage translation projects, components, translations, and languages. Allows creating and listing projects, handling translation components, updating and searching translations, and working with all supported languages in a Weblate instance.
Weblate MCP Server
A Model Context Protocol (MCP) server that provides seamless integration with Weblate translation management platform. This server enables AI assistants to interact directly with your Weblate instance for comprehensive translation management.
🌟 Features
🔧 Complete Weblate API Access: Full integration with Weblate's REST API
🤖 AI-Powered Workflow: Natural language interaction with your translation projects
📊 Project Management: Create, list, and manage translation projects
🔍 Component Operations: Handle translation components and configurations
✏️ Translation Management: Update, search, and manage translations
🌐 Language Support: Work with all supported languages in your Weblate instance
🚀 Multiple Transports: HTTP/SSE, Streamable HTTP, and STDIO support
🛡️ Type Safety: Full TypeScript implementation with comprehensive error handling
⚡ LLM-Optimized: Tools designed to guide AI models toward efficient usage patterns
🎯 What is This?
This MCP server acts as a bridge between AI assistants (like Claude Desktop) and your Weblate translation management platform. Instead of manually navigating the Weblate web interface, you can use natural language to:
"List all projects in my Weblate instance"
"Show me the French translations for the frontend component"
"Update the welcome message translation"
"Create a new translation project"
🚀 Quick Start
Option 1: Use with npx (Recommended)
The easiest way to use this MCP server is with npx - no installation required!
For Claude Desktop or other MCP clients:
Manual testing:
Option 2: Development Setup
Prerequisites
Node.js 18+
pnpm package manager
Weblate instance with API access
Installation
Server runs on http://localhost:3001
by default.
Environment Configuration
🔗 MCP Client Configuration
Claude Desktop (npx method - Recommended)
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json
):
Claude Desktop (Development/Local)
For development or local builds:
HTTP Clients (Cursor, VS Code, Web Apps)
🛠️ Available Tools
📊 Project Management
Tool | Description |
| List all available Weblate projects with URLs and metadata |
🔧 Component Management
Tool | Description |
| List components in a specific project with source language details |
✏️ Translation Management
Tool | Description |
⭐ | Efficient search using Weblate's native filtering syntax |
| Search for translations containing specific text in a project |
| Get translation value for a specific key |
| Update or write translation values with approval support |
⚡ | Batch update multiple translations efficiently with error handling |
| Find all translations for a specific key across languages |
🚀 Why searchUnitsWithFilters is Recommended
The searchUnitsWithFilters
tool uses Weblate's native filtering syntax, making it the most efficient way to find translations:
❌ Inefficient: Getting all keys then checking each one individually (can make thousands of API calls)
✅ Efficient: Single filtered search using Weblate's query syntax
Example efficient queries:
state:=0
- Find untranslated stringsstate:=10
- Find strings that need editingsource:"login"
- Find strings containing "login"component:common AND state:=0
- Complex filters
🌐 Language Management
Tool | Description |
| List languages available in a specific project |
📊 Translation Statistics Dashboard
Tool | Description |
| Comprehensive project statistics with completion rates and string counts |
| Detailed statistics for a specific component |
| Complete dashboard overview with all component statistics |
| Statistics for specific translation (project/component/language) |
| Translation progress for all languages in a component with progress bars |
| Statistics for a language across all projects |
| User contribution statistics and activity metrics |
📈 Change Tracking & History
Tool | Description |
| Recent changes across all projects with user and timestamp filtering |
| Recent changes for a specific project |
| Recent changes for a specific component |
| Recent changes by a specific user |
💡 Usage Examples
Project Operations
Translation Operations
📚 Documentation
Document | Description |
Complete documentation overview and quick start | |
Installation, configuration, and Claude Desktop setup | |
Complete API documentation with examples | |
Contributing, development setup, and testing | |
Codebase structure, patterns, and design decisions | |
Release management and publishing workflow | |
Version management with changesets |
🏗️ Architecture
Technology Stack:
NestJS: Modern Node.js framework with dependency injection
TypeScript: Full type safety and IntelliSense support
Weblate REST API: Comprehensive API wrapper with interfaces
MCP Protocol: Standard Model Context Protocol implementation
Axios: HTTP client for API communication
🧪 Development
Development Setup
Adding New Tools
Create tool file in
src/tools/
Implement MCP tool interface
Add to service providers
Write tests
Update documentation
See Development Guide for detailed instructions.
🎯 Use Cases
Translation Management
Project oversight: Monitor translation progress across projects
Content updates: Update translations programmatically
Quality assurance: Review and approve translations
Team coordination: Manage translation workflows
Development Integration
CI/CD pipelines: Automate translation updates in deployment
Content management: Sync translations with content systems
Localization testing: Validate translations in different contexts
Documentation: Generate translation reports and statistics
AI-Assisted Workflows
Natural language queries: Ask about translation status in plain English
Contextual operations: AI understands your translation needs
Batch operations: Perform bulk updates with AI assistance
Smart suggestions: Get AI-powered translation recommendations
🔒 Security & Production
API Token Security: Store tokens securely, use environment variables
Rate Limiting: Built-in request throttling and retry logic
Error Handling: Comprehensive error responses with debugging info
Input Validation: All inputs validated with Zod schemas
HTTPS Support: Secure communication with Weblate instances
🤝 Contributing
We welcome contributions! Please see our Contributing Guidelines:
Fork the repository
Create a feature branch from main
Implement changes with tests
Update documentation
Submit a pull request
Code Style
Use TypeScript for type safety
Follow NestJS conventions
Add comprehensive tests
Update documentation
📄 License
MIT License - see LICENSE file for details.
🙏 Acknowledgments
Weblate: For providing an excellent translation management platform
Model Context Protocol: For the standardized protocol specification
NestJS: For the robust application framework
Contributors: Everyone who helps improve this project
Built with ❤️ for the translation community
Need help? Check our
Tools
MCP server for managing translation projects in Weblate. With the ability to search, read and write transltaions.
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.Last updated -16MIT License
- AsecurityAlicenseAqualityAn MCP server for fetching and transforming web content into various formats.Last updated -47MIT License
- AsecurityAlicenseAqualityAn MCP server providing machine translation capabilities via the Lara Translate API, featuring language detection and context-aware translations between numerous language pairs.Last updated -18471MIT License
- -securityFlicense-qualityAn MCP server that allows users to interact with their browser through natural language commands, enabling actions like getting page content as markdown, modifying page styles, and searching browser history.Last updated -1