localize.dev

Docs / Agents / Lovable

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

  1. In Connectors, choose Add custom, then MCP server, and enter the URL.
  2. Pick Bearer token or API key, paste your localize.dev API key and click Add server.
  3. 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.
Connectors → Add custom → MCP server
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 --agent adds
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 check

All agents and the tool reference are on the MCP server page.

Framework guides