Homespun

Connect Claude Code to Homespun

Claude Code speaks remote MCP natively, so it can use the hosted connector with nothing running locally. One command registers it, one browser round trip authorizes it, and the Homespun tools are available in every session after that.

  1. Register the connector

    Run the mcp add command in your project directory. It registers Homespun as an HTTP transport MCP server named homespun.

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

  2. Authenticate

    Run /mcp inside Claude Code, select homespun, and choose Authenticate. Your browser opens on the Homespun sign-in and consent screen, and the token is stored for you.

    /mcp

  3. Build something

    Ask Claude Code for the app you want. It creates the app, deploys it to Homespun, and returns the URL, then keeps operating it as the data comes in.

Prefer streaming and local control? The Homespun CLI gives you homespun watch and the full command surface. The remote connector and the CLI are interchangeable, so pick whichever suits the machine you are on, or use both.

If something goes wrong

The two most common snags are a blocked pop-up (the sign-in opens in a new window) and a client that needs a restart before new tools show up. The full troubleshooting list covers the rest, and the docs site explains what a connection can and cannot do.

What to build first

Describe what you want in your own words and your AI builds it. If you would rather start from something proven, install one from the template gallery and change it from the chat.