Updated May 2026Intermediate17 min read

Lovable MCP Server: Build From Claude, Cursor, or Codex (2026)

Lovable opened a remote MCP server at mcp.lovable.dev on May 7, 2026 in Research Preview. Any MCP client — Claude Desktop, Claude Code, Cursor, ChatGPT — can now create, edit, query the cloud database, and deploy Lovable projects from outside the Lovable browser editor. This is the developer-grade tour: the endpoint, the OAuth flow, the 50-plus tools, the credit costs, and the gotcha that bit me first.

Hero illustration: a luminous teal AI client glyph on the left connected to a luminous teal app-preview glyph on the right by a dot-and-dash light arc, on a midnight navy background with faint coral-pink accent particles.
On this page · 17 sections
  1. One-sentence definition
  2. Why Lovable shipped this
  3. Mental model
  4. Smallest end-to-end example
  5. The 50+ tools
  6. Chat connectors vs MCP server
  7. Real workflows
  8. What I got wrong
  9. Common mistakes
  10. Cost & credits
  11. Who this is for
  12. Community signal
  13. The verdict
  14. The bigger picture
  15. FAQ
  16. Glossary
  17. All sources

One-sentence definition

The Lovable MCP server is a remote Model Context Protocol endpoint at https://mcp.lovable.dev that gives any MCP client OAuth-authenticated access to your Lovable workspace — create_project, send_message, get_diff, query_database, deploy_project, and forty-plus more tools — over Streamable HTTP, billed against your normal Lovable credit balance and gated to Pro and Business plans.

That sentence is the whole launch. Everything below unpacks one of its words.

Why Lovable shipped this

Before today, Lovable was a destination. You opened the browser editor, prompted the agent, watched the preview pane build, and clicked Deploy. The agent lived in Lovable’s window, and your other tools lived everywhere else.

Lovable spent late 2025 inverting half of that. In November 2025 they shipped chat connectors — MCP support that lets the Lovable agent read Notion, Linear, Jira, Confluence, n8n, Miro, Sentry, and a dozen more. That made Lovable an MCP client. The agent stays inside Lovable’s window; the context flows in.

Today’s launch flips the other half. The Lovable MCP server makes Lovable an MCP server — so the agent flows out. Claude Code in your terminal, Cursor in your editor, ChatGPT on your phone, all of them can now call Lovable’s tools without opening the browser editor. The pitch is exactly the symmetry: one protocol, both directions, one product surface.

Research Preview — expect breaking changes

The launch is labeled Research Preview. Quoting the docs: “Tool names, parameters, and response shapes may change without notice, including breaking changes.” Don’t hard-code tool names into production scripts yet. Wrap calls in a thin adapter so a rename doesn’t cascade.

Mental model: the four named pieces

Once you have these four pieces, the rest of the docs is a deeper read of one of them.

┌──────────────┐                  ┌─────────────────────────────┐
│  Claude      │                  │   mcp.lovable.dev           │
│  Cursor      │ ── streamable ──▶│                             │
│  ChatGPT     │      http        │   ┌─────────────────────┐   │
│  Codex (soon)│ ◀── tool result ─│   │  OAuth or lov_ key  │   │
└──────────────┘                  │   └─────────────────────┘   │
                                  │            │                │
                                  │            ▼                │
                                  │   ┌─────────────────────┐   │
                                  │   │  50+ tools          │   │
                                  │   │  ─────────────      │   │
                                  │   │  projects · agent   │   │
                                  │   │  code · knowledge   │   │
                                  │   │  database · MCPs    │   │
                                  │   │  analytics · upload │   │
                                  │   └─────────────────────┘   │
                                  │            │                │
                                  │            ▼                │
                                  │   Lovable workspace credits │
                                  └─────────────────────────────┘
  • The endpoint — one URL, https://mcp.lovable.dev, hosted by Lovable. Streamable HTTP transport. You don’t deploy anything.
  • The auth layer — OAuth in the browser on first connect for desktop clients, or an API key prefixed lov_ in the Lovable-API-Key header for headless or scripted use. Scope is the entire workspace, not a single project.
  • The tool surface — about fifty tools spread across eight categories: projects, agent interaction, code inspection, knowledge, cloud database, connected MCP servers, analytics, file uploads. Inventory in the next section.
  • The credit billing — tools that call the Lovable agent (create_project, send_message) debit your workspace credit balance just like in-editor prompts. Read-only tools cost nothing. Pro plan ships with 100 credits a month.

One more concept matters before setup: scope. The MCP server hands the calling client access to every project in the workspace. There is no per-project token. If you wire an autonomous agent to your main workspace, it can read, write, and deploy anything in there. Use a dedicated test workspace until you trust the loop.

Smallest end-to-end example

Five steps to a working setup, then one prompt to prove it works.

Setup in Claude Code

One command in your terminal:

claude mcp add --transport http lovable "https://mcp.lovable.dev"

Claude Code will open a browser the first time it calls the server. Authorize on the Lovable OAuth screen. Tools show up in the next session.

Setup in Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "lovable": {
      "type": "http",
      "url": "https://mcp.lovable.dev"
    }
  }
}

Restart Claude Desktop. OAuth fires on the first tool call.

Setup in Cursor

Cursor needs an explicit OAuth client ID. The docs publish one:

{
  "mcpServers": {
    "lovable": {
      "type": "http",
      "url": "https://mcp.lovable.dev",
      "auth": {
        "CLIENT_ID": "6d465f583e1e4ce5801b1616f735670c"
      }
    }
  }
}

Headless (CI, scripts, server agents)

Generate an API key from your workspace under Settings → API keys. The key starts with lov_. Send it on every request:

Lovable-API-Key: lov_your-api-key-here

The header bypasses the OAuth flow entirely — useful for cron, background agents, and headless continuous-deploy hooks.

Your first real prompt

Once connected, ask Claude (or Cursor) something like:

List my Lovable projects, find the one called "checkout-poc",
show me the diff from the last edit, then deploy it.

What happens behind the chat:

  • Claude calls list_projects with a search filter. Free.
  • Claude calls list_edits on the matching project. Free.
  • Claude calls get_diff with the latest message ID. Free.
  • Claude shows you the diff inline and asks for confirmation.
  • On yes, Claude calls deploy_project. Returns the live URL. Free (deploy itself doesn’t consume credits; the underlying agent run that produced the build did).

Total cost: zero credits if the project was already built. If the prompt asked Claude to make a change first via send_message, that single agent call debits credits at the same rate as an in-editor prompt — roughly 0.5 to 1.5 credits per ask, per Lovable’s current credit math.

The 50+ tools, organized

The full surface is large but the categories are tight. Here is the lineup straight from the docs.

Projects & workspaces

  • get_me — profile + workspaces
  • list_workspaces
  • get_workspace
  • list_projects — full-text search
  • get_project — URLs + screenshot
  • create_project
  • deploy_project
  • remix_project
  • set_project_visibility
  • set_folder_visibility
  • list_template_projects
  • list_library_projects

Agent interaction

  • send_message — prompt the agent, optional plan_mode
  • get_message — poll async completions

Code inspection

  • get_diff — unified diff per message or SHA
  • list_files — tree at a git ref
  • read_file — contents at a git ref
  • list_edits — paginated history

Knowledge / governance

  • get_workspace_knowledge
  • set_workspace_knowledge
  • get_project_knowledge
  • set_project_knowledge

Analytics & uploads

  • get_project_analytics
  • get_project_analytics_trend
  • get_file_upload_url — presigned attachments

Cloud database

  • get_database_status
  • enable_database — provisions in 30–60s
  • query_database — raw SQL
  • get_database_connection_info

Connected MCP servers

  • list_mcp_servers / list_mcp_catalog
  • list_connectors / list_connections
  • add_mcp_server / remove_mcp_server

Opinion: the under-priced tools are the read-only ones. list_projects, get_diff, list_files, read_file, get_project_analytics — all free, all give Claude an instant audit surface across every project you own. The interesting workflows aren’t about spending credits. They’re about asking cross-project questions you couldn’t answer inside the Lovable editor — which of my 12 projects use Supabase auth?which one had the regression in last Tuesday’s edit? Claude can answer those for free; the editor cannot.

Chat connectors vs the MCP server

Lovable now has two MCP-shaped surfaces and the names blur together. Keep them straight.

 Chat connectorsLovable MCP server
DirectionLovable is the clientLovable is the server
Who calls whoLovable agent calls Notion / Linear / Jira / MiroClaude / Cursor / ChatGPT calls Lovable
ShippedNovember 18, 2025May 7, 2026 (Research Preview)
Plan tierPrebuilt on all plans, custom on paidPro or Business required
EndpointInside Lovable settings UImcp.lovable.dev

Same protocol, opposite arrows. The chat-connector catalog at last count includes Amplitude, Atlassian (Jira, Confluence), Confidence, Granola, Hex, HeyGen, Linear, Miro, Notion, n8n, Polar, PostHog, Sanity, and Sentry. Useful when the Lovable agent needs context; irrelevant if you’re trying to drive Lovable from outside.

Real workflows you can build today

Five workflows worth wiring up in the first week.

1. Cross-project audit from your terminal

Claude Code with the Lovable MCP installed answers questions the Lovable editor can’t. List every project that touched supabase.auth in the last 30 days. Show me the projects without a custom domain set. Which workspace knowledge entries reference the old payments provider? Pure read-only, cross-workspace, free.

2. Spec-to-app from a Notion brief

Claude reads a Notion doc (via the official Notion MCP), extracts the requirements, and calls create_project with the brief as the initial message. The Lovable agent does the build inside the container. Claude polls get_message, fetches the diff, summarizes, and offers to deploy.

3. CI hook that QAs every Lovable deploy

A GitHub Action with a lov_ API key calls list_edits on a deploy, pulls get_diff + key read_file contents, and runs them through a Codex CLI test suite. If the Lovable agent regressed your checkout flow, you find out before the live URL goes public.

4. Database migration from the IDE

Cursor with the MCP installed lets you craft a SQL migration in your editor, run it via query_database, see the result inline, and only commit the migration to the project when the run succeeds. The Lovable Cloud database becomes a first-class IDE target instead of a browser tab.

5. Remix-and-customize from a template gallery

Claude calls list_template_projects, presents three options, and on your pick fires remix_project — gets you a clone in your workspace — then send_message with your customization brief. The whole onboarding-from-template flow happens in chat, no UI clicks.

What I got wrong

Three assumptions that turned out to be wrong.

1. I thought the API key was per-project. It isn’t. The lov_ key scopes to the whole workspace. Every project, every database, every edit history, every analytics endpoint. Treat the key like a workspace owner credential, not a feature toggle. If you’re wiring it into an autonomous agent, do it in a separate workspace and pay $25 a month to keep blast radius small.

2. I assumed read-only tools were always free. They are — until you chain them.list_projects with a wide filter on a workspace with 50 projects can pull a meaningful payload that your client’s context window has to hold. The cost isn’t Lovable credits, it’s Claude / Cursor / ChatGPT input tokens. Filter aggressively and page through results.

3. I treated “Research Preview” as “mostly stable, like a beta.” It isn’t. The docs are explicit: “Tool names, parameters, and response shapes may change without notice, including breaking changes.” Don’t bake the tool list into a CLI you ship to customers yet. Write a thin adapter layer in your client code so a rename means one file edit, not twelve.

Common mistakes

Confusing the chat connector with the MCP server

Root cause: both ship under the “MCP” banner. If you want Claude to drive Lovable, you want the server (mcp.lovable.dev). If you want the Lovable agent to read your Notion docs, you want the chat connectors UI inside Lovable. The product names are confusing; the direction is the disambiguator.

Trying it on the Free plan

Root cause: the docs require Pro or Business. OAuth will succeed against a Free account but tool calls return permission errors. If you see immediate 403s after a clean OAuth, check your plan tier first.

Forgetting to enable the database before query_database

Root cause: get_database_status tells you whether Lovable Cloud is on for a project; if not, enable_database kicks off a 30 to 60-second provision. Skipping the status check means Claude swings at query_database and gets a confusing “not enabled” error instead of waiting.

Holding the API key in plaintext config

Root cause: lov_ keys grant full workspace access. Pasting one into a committed Cursor or VS Code workspace config is the same as pasting an AWS access key. Use your client’s secret-store path, env vars, or a 1Password CLI expansion. Rotate immediately if you suspect exposure.

Burning credits via accidental send_message loops

Root cause: an autonomous agent that retries on a timeout will fire send_message twice and bill twice. Use get_message with the original message ID to poll instead of re-sending. Pro plan’s 100 monthly credits disappear fast under a runaway loop.

Cost & credits, in practice

Lovable’s credit model is granular as of mid-2025: minor edits cost as little as 0.5 credits, complex builds 1.5+. Pro ships 100 credits a month for $25; Business ships 100 credits for $50 with team features. Top-ups are $15 per 50 credits on Pro.

From the MCP server, what costs what:

  • Free: all list_*, get_* read-only tools, get_diff, read_file, get_project_analytics, set_project_knowledge, list_mcp_catalog, deploy itself.
  • Credits: create_project (initial agent run), send_message (every prompt that runs the agent).
  • Token-bound (your client’s side): every tool returns JSON your client adds to its own context window. Big payloads — full file trees, long diff blobs — cost Claude or Cursor input tokens, not Lovable credits. The cheap tools can still bloat your client.

Practical budget: a 30-minute Lovable-driven prototyping session from Claude Code burned 8–12 credits in my test — comparable to running the same flow inside the Lovable editor. The MCP doesn’t add a markup; it just lets you call from a different surface.

Who this is for, who it isn’t

Use the Lovable MCP server if

  • You ship 5+ Lovable prototypes a month and want to drive them from your editor.
  • Your team uses Claude Code or Cursor as primary tooling and Lovable as a build target.
  • You want CI hooks that QA Lovable deploys before they go live.
  • You manage 10+ projects and need cross-project audits.
  • You combine Lovable Cloud’s SQL with non-Lovable analyses.

Skip it if

  • You ship one Lovable app a quarter — the browser editor is fine.
  • You’re on the Free plan — the MCP requires Pro or Business.
  • You need per-project access scoping — today’s key is workspace-wide.
  • You want production-stable tool names — Research Preview will rename.
  • Your security team blocks any third-party API key with full account scope until SOC 2 audited.

Community signal

Lovable announced the launch on X today. The tweet is short and concrete — the kind of launch post that tells you they want developers paying attention, not the usual marketing copy.

The launch sits on top of six months of MCP scaffolding. In November 2025, Lovable opened the inbound side — their chat connectors let the agent read Notion, Linear, Jira, and Confluence. Notion celebrated that launch:

Today’s launch is the symmetric piece. The community had been wiring the inverse for months — Prajwal Tomar’s Despia integration is one representative example: an MCP that takes a Lovable web app and ships it as an App Store / Play Store mobile app.

The contrarian voice deserves equal airtime. In April 2026, Lovable spent 48 days with a BOLA vulnerability that exposed source code, Supabase credentials, and AI chat histories on projects created before November 2025. Lovable’s response post acknowledged the issue and patched it. None of that is the MCP server’s fault, but it sets the trust weather. The MCP server hands a third-party AI agent workspace-wide write access. That’s a meaningful uplift in capability and a meaningful uplift in blast radius. Use a separate workspace until you trust the loop.

The verdict

Our take

Wire it up if you ship multiple Lovable projects a month and your daily editor is Claude Code, Cursor, or ChatGPT. The cross-project audit and CI-hook workflows alone justify the Pro plan, and the symmetry with chat connectors is what turns Lovable from a destination into a programmable build target.

Skip it if you ship one Lovable app a quarter, if you’re on the Free tier, or if your security team blocks workspace-scoped API keys until a SOC 2 audit lands. Research Preview is honest about what it is — the tool surface will rename. Build a thin adapter, and don’t put the tool list in a customer-facing CLI yet.

The bigger picture

Three trends converge at this launch.

App builders are becoming MCP servers. Replit, v0, Bolt, and now Lovable each have a story for exposing their build surface to other agents. The day where you pick your AI app builder by which integrates with your terminal is closer than the day where you pick it by who has the prettiest preview pane.

Workspace-scoped tokens are a 2026 question. Lovable’s lov_ key joins github_pat_, sk-, and a dozen other broad-scope tokens that AI agents are now allowed to wield. The next year will tell us whether the industry settles on per-project OAuth scopes or just accepts that agent credentials are workspace credentials. The security incidents of 2026 argue for the former; the product velocity of 2026 argues for the latter.

The IDE is becoming the universal AI surface. Claude Code can now drive your design tool (Stitch), your video tool (Pika), your ad platform (Meta Ads), your image stack (Higgsfield), and now your app builder (Lovable). Every “product” in 2026 ships an MCP server because every developer is starting to expect one. Lovable just paid the table-stakes price.

Frequently asked questions

What is the Lovable MCP server URL?

The remote endpoint is https://mcp.lovable.dev. You add it as a streamable-HTTP MCP server in Claude Desktop, Claude Code, Cursor, or any other MCP client. First connection opens a browser OAuth flow against your Lovable account; headless use takes an API key prefixed with lov_ via the Lovable-API-Key header.

Do I need a paid plan to use the Lovable MCP server?

Yes. The docs require a Pro ($25/mo) or Business ($50/mo) plan. The Free tier does not expose the MCP server. Credits consumed by tools like create_project and send_message debit your normal workspace credit balance — there is no separate MCP wallet.

How is this different from Lovable's chat connectors (Notion, Linear, Jira)?

Opposite directions. Chat connectors make Lovable the MCP client — Lovable reads from Notion, Linear, Confluence, Jira, n8n, Miro. The Lovable MCP server makes Lovable the MCP server — Claude, Cursor, or any other MCP client reads from and writes to your Lovable account. Same protocol, reversed roles.

Does the Lovable MCP server use my Lovable credits?

Tools that call the Lovable agent — create_project, send_message — consume workspace credits at the normal rate. Read-only tools (list_projects, get_diff, list_files, read_file, get_database_status) are free. Watch the Pro plan's 100 monthly credits if you trigger a lot of generations from outside.

Can I use the Lovable MCP server with ChatGPT or Codex?

Yes for ChatGPT custom connectors and any MCP-compatible client. The docs explicitly list Claude Desktop, Claude Code, Cursor, and ChatGPT. Codex CLI support is documented as 'coming soon' as of the May 7, 2026 launch — check the docs page for the current status.

Is the Lovable MCP server safe given the April 2026 security incident?

The April 2026 BOLA leak was a separate platform issue patched before MCP launch — but treat the MCP server's full-account scope seriously. API keys grant access to every project in the workspace, not per-project. Rotate any key you stop using, scope server-side firewall rules where possible, and keep a separate test workspace if you wire it to autonomous agents.

What's the difference from the unofficial hiromima/lovable-mcp-server on GitHub?

The hiromima repo is a community-built local MCP server that analyzes a Lovable project on disk for use with Claude Desktop. It is read-only and never connects to Lovable's API. The official mcp.lovable.dev is hosted by Lovable, OAuth-authenticated, and exposes write tools (create, deploy, query the cloud database). They solve different problems.

Glossary

Lovable MCP server

Remote MCP endpoint at mcp.lovable.dev that exposes the Lovable workspace to any MCP client.

mcp.lovable.dev

The hosted endpoint URL. Streamable HTTP transport. OAuth + lov_ key auth.

lov_ API key

Workspace-scoped headless auth token. Sent via Lovable-API-Key header.

Streamable HTTP

Modern MCP transport for remote servers. Replaces SSE; long-lived bidirectional stream.

Research Preview

Lovable's term for the launch tier. Tool names and shapes may change without notice.

Chat connector

Lovable's other MCP feature. Lovable is the client; pulls context from Notion, Linear, etc.

Lovable Cloud

Lovable's hosted Postgres + auth + storage layer. Provisioned via enable_database.

Workspace credit

Lovable's billing unit. 100/mo on Pro. Consumed by send_message and create_project.

plan_mode

send_message option that asks the agent to discuss a plan before writing code.

Remix

Lovable's term for cloning a project (template, library, or public) into your workspace.

BOLA

Broken Object Level Authorization. Class of vuln behind Lovable's April 2026 incident.

MCP client

The side of the protocol that calls tools. Claude Desktop, Cursor, ChatGPT, Lovable's chat connectors are all clients.

All sources

Primary — Lovable

Community and analysis

Contrarian and risk

Internal — on MCP.Directory

Keep reading