SimpleLocalize
SimpleLocalize is a translation management platform for managing localization keys, translations, languages, imports, exports, and hosted environments.
Verdict
Common use cases
- Draft translation keys during feature kickoffs
- Export localized strings for production builds
- Audit missing translations before release
- Tag keys by feature or sprint
- Delete deprecated strings in bulk
Integration
- Vendor
- SimpleLocalize
- Category
- developer-tools
- Auth
- API_KEY
- Tools
- 14
- Composio slug
simple_localize
Tools
- Create Tag
Create a project tag for organizing translation keys.
- Create Translation Key
Create one translation key and optional metadata in the connected project.
- Create Translation Keys
Create up to 100 translation keys and report every rejected entry; valid entries may still be created when others fail.
- Delete Tagdestructive
Permanently delete one project tag by its exact name. This destructive action cannot be undone.
- Delete Translation Keydestructive
Permanently delete one translation key, including all translations attached to it, by exact key and namespace. WARNING: This destructive action cannot be undone.
- Export Translations
Create downloadable snapshot URLs for project translations in a selected file format. Returns URLs without downloading file bytes.
- Get Project Context
Return the connected project and its current languages, tags, and hosting environments so an agent can choose valid identifiers before managing translations.
- Get Translation Key
Return full metadata for one translation key selected by key and namespace.
- List Activity
Return a manually selected page of recent project changes for operational visibility.
- List File Formats
Return the file formats currently accepted by SimpleLocalize exports, including multi-language, beta, and deprecation metadata.
- List Translation Keys
Search translation keys and return one controllable page of provider summary fields. Use Get Translation Key for detailed metadata such as tags.
- List Translations
Search translations by key, language, text, review state, or namespace and return one page.
- Set Translation
Set the text and optional review state for one existing translation key and language.
- Set Translations
Set 1 to 100 translations in one request. Reports each rejected entry and distinguishes complete success from partial success.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings → Integrations → Developer Tools. 2. Find SimpleLocalize in the list and click Connect. 3. You'll be prompted to paste an API key; generate one in your SimpleLocalize dashboard under Project Settings → API. 4. Grant the key read and write permissions if you want to create or delete translation keys; read-only access limits you to exports and lookups. 5. Paste the key into Switchy and click Authorize. 6. Switchy confirms the connection and displays your project name and available languages. 7. Open any Project, type '@SimpleLocalize what languages are configured?' and send—if you see a list of locales, the integration is live. 8. To test a write operation, try '@SimpleLocalize create a translation key named test.welcome in the default namespace' and check your SimpleLocalize dashboard for the new entry.
What teammates see: by default, memories from SimpleLocalize are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Project Languages
@SimpleLocalize show me all languages and hosting environments in this project
Create Feature Keys
@SimpleLocalize create translation keys for a checkout flow: checkout.title, checkout.submit, checkout.cancel, checkout.error
Export for Deployment
@SimpleLocalize export all translations as JSON and give me the download URLs
Tag Sprint Work
@SimpleLocalize create a tag called 'sprint-42' and list all keys currently tagged with it
Audit Missing Strings
@SimpleLocalize find all keys that are missing French translations and show me the key names
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@SimpleLocalize list all translation keys tagged 'onboarding' and show which languages are missing translations
Found 12 translation keys tagged 'onboarding' across your project. Complete translations exist for English (en) and Spanish (es). Missing translations: French (fr) is missing 7 keys including 'welcome.title' and 'step_2.description'; German (de) is missing 4 keys including 'complete.button' and 'skip.link'. All keys use the default namespace. You can filter by namespace or export these gaps as a CSV if needed.
This example combines Get Project Context with translation key queries to surface localization gaps. Requires API key with read access to translation keys and project metadata. The MCP returns structured data but doesn't automatically create missing translations—you'll need a follow-up prompt to generate or import them.
@SimpleLocalize create a new translation key 'dashboard.welcome_back' with English text 'Welcome back, {username}!' and mark it with tag 'dashboard-v2'
Translation key 'dashboard.welcome_back' created successfully in the default namespace. Added English (en) translation: 'Welcome back, {username}!'. Applied tag 'dashboard-v2' for organization. The key is now available in your project and will appear in the next export. Note: Other configured languages (es, fr, de) still need translations for this key—they're currently empty.
Demonstrates the Create Translation Key tool with metadata tagging. This is a write operation that immediately modifies your SimpleLocalize project. The MCP creates the key but doesn't auto-translate to other languages—you'll see gaps until you add those translations manually or via batch import. Requires API key with write permissions.
@SimpleLocalize export all translations for the 'production' environment as JSON files and give me the download URLs
Export initiated for production environment. Generated 4 downloadable snapshots: English (en) at https://cdn.simplelocalize.io/abc123/en.json (47 KB, 156 keys), Spanish (es) at https://cdn.simplelocalize.io/abc123/es.json (45 KB, 156 keys), French (fr) at https://cdn.simplelocalize.io/abc123/fr.json (41 KB, 149 keys), German (de) at https://cdn.simplelocalize.io/abc123/de.json (43 KB, 152 keys). URLs expire in 24 hours. The MCP returns URLs only—you'll need to download the files separately if you want to inspect content locally.
Uses Export Translations to create deployment-ready snapshots filtered by hosting environment. The MCP doesn't return file bytes—it generates temporary CDN URLs that you fetch yourself. Useful for CI/CD pipelines or auditing what's live in production. Requires read access and a valid environment name from your project configuration.
Use-case deep-dives
When SimpleLocalize beats spreadsheets for launch coordination
A 6-person product team shipping a web app in English, Spanish, and German hits the wall two weeks before launch: translations live in three Google Sheets, engineers are hard-coding keys, and nobody knows which strings are final. SimpleLocalize wins here because the Create Translation Keys tool lets non-technical PMs batch-upload 100 keys at once while devs pull live snapshots with Export Translations. The Get Project Context tool shows everyone the same language list and tag structure, so there's no key-name drift between design mocks and production. If your launch cadence is quarterly or slower, a spreadsheet still works. But if you're shipping features every sprint and translations lag by days, the API_KEY auth and 14-tool scope justify the setup cost. Book a 30-minute onboarding call to map your current key-naming convention to SimpleLocalize's namespace model before your next release.
Why SimpleLocalize falls short for support-team translation workflows
A 3-person support team at a SaaS company wants to translate 40 Zendesk macros into French and Portuguese. They're eyeing SimpleLocalize because it has translation-key management, but this scenario is borderline at best. The toolset is built for developer-driven workflows—Create Translation Key and Get Translation Key assume you're working with namespaces and structured keys, not freeform support copy. The team would spend more time learning the namespace model than they'd save over a simpler tool like Phrase or even a shared Notion doc. SimpleLocalize shines when engineers are in the loop and keys map to UI components. If your support team isn't committing code or syncing translations to a build pipeline, the 14-tool complexity is overkill. Save the API_KEY setup for product translation; use a lightweight copy-management tool for support macros instead.
When tag-based organization justifies SimpleLocalize for agency work
A 5-person dev agency builds white-label dashboards for healthcare clients. Each client gets a fork of the same React app, but translations vary by region and compliance requirements. The Create Tag and Delete Tag tools let the agency organize keys by client name and feature set, so handoff docs are clean and the client's internal team can filter keys without touching code. Export Translations generates per-client snapshots in JSON or CSV, and Get Project Context confirms which tags exist before the agency archives a project. The trade-off: if you're only managing one or two clients, tags are unnecessary overhead—just use separate SimpleLocalize projects. But once you hit three or more forks with overlapping translation sets, the tag system pays for itself in handoff clarity. Agencies billing $150+ per hour should budget two hours for initial tag-structure design and one hour per client onboarding.
Frequently asked
What does the SimpleLocalize MCP do in Switchy?
It lets AI agents create, update, and delete translation keys across your SimpleLocalize project without leaving the chat. Agents can export translation snapshots, manage tags, and check which languages are configured. Useful when you're iterating on copy and want to push strings directly to your localisation workflow instead of switching between tools.
Do I need admin access to connect SimpleLocalize?
You need a SimpleLocalize API key with write permissions to your project. Generate one in your SimpleLocalize account settings, then paste it into Switchy's auth flow. Read-only keys won't work because the MCP creates and deletes translation keys. Anyone on your team with a valid API key can connect their own instance.
Can the MCP auto-translate strings into other languages?
No. It manages translation keys and exports existing translations, but it doesn't call SimpleLocalize's machine translation API. If you want AI to draft translations, you'd ask the agent to write the text in chat, then use the Create Translation Key tool to push each language variant manually. The MCP is for key management, not translation generation.
How is this different from editing translations in SimpleLocalize's dashboard?
The dashboard is faster for bulk edits and reviewing translation status. The MCP is better when you're prototyping features in chat and want to create keys on the fly without context-switching. You also get a transcript of every change the agent made, which helps when you need to audit what strings were added during a session.
Who on the team should connect this MCP?
Whoever writes copy or manages your translation keys—usually product managers, developers, or content leads. Each person connects their own API key, so changes are tied to their SimpleLocalize account. If your team shares one API key, you'll lose per-user audit trails. The MCP doesn't count against Switchy plan limits; it's just another integration.