Lovable MCP

The official Model Context Protocol server for Lovable, an AI-powered full-stack app builder.

Connect Claude, Cursor, Codex, and other MCP-compatible clients to Lovable so they can create, edit, deploy, and manage Lovable projects through natural language.

Endpoint

https://mcp.lovable.dev

Transport: Streamable HTTP.

Authentication

OAuth 2.1. MCP clients discover the authorization server via RFC 9728 metadata at https://mcp.lovable.dev/.well-known/oauth-protected-resource and obtain a bearer token automatically. The token is passed as Authorization: Bearer <token>.

Install

Claude, Claude Code, and ChatGPT need only the URL. Any other client must also pass Lovable's public OAuth client ID (6d465f583e1e4ce5801b1616f735670c), shown below.

Claude Code

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

Claude Desktop

Add to claude_desktop_config.json:

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

ChatGPT

Add the URL directly — no client ID needed:

https://mcp.lovable.dev

Cursor / Windsurf

Add to your client's MCP config (~/.cursor/mcp.json, or Windsurf's mcp_config.json):

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

VS Code

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

Codex CLI

codex mcp add lovable --url https://mcp.lovable.dev
codex mcp login lovable

Other clients

Use the same type: http + url + auth.CLIENT_ID shape as the Cursor example above.

Tools

The server exposes tools across these areas:

Projects & workspaces — list, create, deploy, remix, inspect; manage visibility
Agent interaction — send messages to a project's AI agent and retrieve responses
Code inspection — diffs, file tree, file contents, edit history
Knowledge — read and write project / workspace AI instructions
Cloud database — enable a Postgres database, check status, run SQL, get connection info
Connectors & MCP servers — list, add, and remove external integrations (Linear, Notion, Slack, custom MCP, …)
Templates & libraries — browse template and library projects
Analytics — historical and real-time project traffic
File uploads — generate upload URLs for attaching images

Heads up: create_project and send_message consume Lovable build credits. deploy_project publishes a public URL. query_database runs SQL directly against your project's database.

See the Lovable MCP documentation for the full tool reference.

Common workflow

Build and deploy a new app:

1. list_workspaces()                       → workspace_id
2. create_project(workspace_id, ...)       → project_id   (uses credits)
3. send_message(project_id, "Add ...")     → message_id   (uses credits)
4. get_diff(project_id, message_id)        → review changes
5. deploy_project(project_id)              → live URL

Most tools need a workspace_id — call list_workspaces first. read_file needs a git ref; get latest_commit_sha from get_project.

Troubleshooting

Symptom	Fix
`401 Unauthorized` / expired token	Re-run your client's login flow to refresh the OAuth token
OAuth window loops or never completes	Confirm the client passes the `auth.CLIENT_ID` shown above
"Transport not supported"	The client must support Streamable HTTP
Tool fails on a missing `workspace_id`	Call `list_workspaces` first and pass the returned ID

Registry

This repository hosts the server.json entry for the MCP registry.

License

Apache License 2.0