Skip to content
MCP server

Homespun

Deploy a multi-user web app from your agent, with hosting, sign-in and database

Install
Pricing
Free
Platforms
Web, API, CLI
Runs
Locally or Remotely
Version
1.6.98
Listing updated
2 days ago

About Homespun

Homespun is a free MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

Homespun is aimed at people who want an assistant to build a small working app, such as a booking page, order form or rota, and then keep using it. The app gets its own web address, magic-link sign-in for the people you invite, a shared realtime database with per-role permissions, email notifications and file attachments, and the site says it is online in about 10 minutes. The assistant signs in as an ordinary user, so a week later it can read the rows customers wrote, add a field, change a price or send a reminder on the live app.

Apps start private; only you and invited people can open one, who see your name and never your email, and each app runs on its own address so it cannot reach your account. You can switch to link sharing or public later.

The npm package is a thin stdio wrapper around Homespun's relay, with full parity with the homespun command line tool and a shared agent identity in ~/.config/homespun/config.json. If no API key is set, it registers an agent on first use. Because MCP tools are request and response, changes are followed by polling get_feed_events with a cursor, or re-calling list_rows. It needs Node.js 20 or newer, and a hosted Streamable HTTP endpoint exists at homespun.dev/mcp. It is free during early access.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://homespun.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "homespun": {
      "url": "https://homespun.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "homespun": {
      "type": "http",
      "url": "https://homespun.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "homespun": {
      "serverUrl": "https://homespun.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

  • HOMESPUN_API_KEYHomespun agent API key. If unset, the server auto-registers a fresh agent against the relay on first use and saves the key to the shared CLI store (~/.config/homespun/config.json).
  • HOMESPUN_URLHomespun relay base URL. Defaults to the hosted relay https://homespun.dev; set this to point at a different relay.
  • HOMESPUN_AGENT_NAMEDisplay name for the auto-registered agent on the relay.
  • HOMESPUN_REGISTER_SECRETRegistration secret, required only for relays running REGISTRATION_MODE=secret.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

get_feed_events
Polls for changes since a cursor, with optional long polling.
list_rows
Lists rows in a collection, with a since cursor for watching changes.

What it does

One-call app deploy
Creates a hosted multi-user web app with its own address.
Built-in sign-in
Invited people sign in with magic links and see only your name.
Shared realtime database
Stores app data with per-role permissions that the assistant can read later.
Email and attachments
Includes email notifications and file attachments.
Private by default
Apps are private until you choose link sharing or public access.
CLI parity
Every command line capability is reachable through the server.
Polling feed
Tracks changes through get_feed_events with a cursor and optional long polling.

Good for

  • Build a booking page for a small service business
  • Run an RSVP list or carpool rota for a group
  • Collect quote requests and have the assistant summarise them
  • Add a field or change a price on a live app by asking
  • Keep a home upkeep log shared with family

Pricing

Free

Free during early access; future pricing not announced

Prices change. Check homespun.dev before you buy.

Homespun FAQ

What does it cost?

The site says it is free in early access with no card, and that users will be told before charging begins.

Which clients work?

Claude, Claude Code, Cursor, Antigravity, OpenCode and Codex, plus anything that speaks MCP; a command line tool is also available.

Do I need an API key?

No. If HOMESPUN_API_KEY is unset, the server registers an agent on first use and saves the key locally.

Who can open my app?

Only you and the people you invite, until you choose link sharing or public.

What Node version is needed?

Node.js 20 or newer for the npm package.

Is Homespun free?

Yes. Homespun is free to use.

How do I add Homespun to Claude Code?

Run this command in your terminal: claude mcp add --transport http homespun https://homespun.dev/mcp

What are the best alternatives to Homespun?

The closest alternatives to Homespun are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Homespun

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity