Localize a Lovable app
Connect Lovable to the hosted localize.dev MCP server, and its agent finds the hardcoded text in your app, gives it keys, sets up react-i18next and translates it. The translations stay in your code as locale files, with no script or proxy in front of the site.
How it works
Lovable runs in the browser, so it can't start npx. It connects to the hosted server at https://uselocalize.dev/api/mcp instead: the agent sends the files a tool needs and writes back the files it returns.
The connector belongs to your Lovable account, not the app, so your API key is never part of the published site. check and config don't use your allowance; localize, translate and add_language do.
Set it up
First create an API key in the dashboard. Create a key
- In Connectors, choose Add custom, then MCP server, and enter the URL.
- Pick Bearer token or API key, paste your localize.dev API key and click Add server.
- Open your project and ask something like the prompt below. The agent sends the files the tool needs and writes back the files it returns.
Name localize
URL https://uselocalize.dev/api/mcp
Authentication Bearer token or API key
Key ldv_live_… (your localize.dev API key)What you get
- Where the server goes
Connectors → Add custom → MCP server- Server
- The hosted server at
https://uselocalize.dev/api/mcp - Key
- Your localize.dev API key, as a bearer token
- What
init --agentadds - Nothing: a browser builder can't run npx, so it connects to the hosted server.
Good to know
- Ask for a check first. It lists hardcoded text and missing translations file by file, so you can pick the pages to localize.
- If the project syncs to GitHub, the localize.dev GitHub Action can also translate every push and open one pull request with the keys and translations.
Try it
Ask something like this. The agent should call the check tool.
“Check this app for hardcoded text and tell me what isn't translated.”
Keep it translated
Text the agent leaves hardcoded still gets caught: npx localize-dev check in CI fails a pull request that adds untranslated copy, and it needs no key.
npx localize-dev checkAll agents and the tool reference are on the MCP server page.