lovie

lovie — Company Formation MCP Server

The Company Formation MCP for AI coding tools. Form companies, manage bank accounts, cards, invoices, and more — directly from your terminal.

Quick Start

npm install -g lovie

1. Log in

lovie login

This opens your browser to authenticate with your Lovie account.

2. Add to your AI tool

Claude Code

To add Lovie globally (available in all projects):

claude mcp add --scope user lovie npx lovie

To add Lovie to the current project only:

claude mcp add lovie npx lovie

Cursor — add to .cursor/mcp.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Windsurf — add to mcp_config.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Claude Desktop — add to claude_desktop_config.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

VS Code / GitHub Copilot — add to .vscode/mcp.json

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Replit — add to .replit or use the MCP panel in Replit Agent

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Lovable — in the MCP integration settings, add:

• Name: lovie
• Command: npx
• Arguments: -y lovie

Manus — in the MCP tool configuration, add:

• Name: lovie
• Command: npx
• Arguments: -y lovie

OpenAI (ChatGPT / Codex) — if MCP is supported, use the same stdio config:

{
  "mcpServers": {
    "lovie": {
      "command": "npx",
      "args": ["-y", "lovie"]
    }
  }
}

Any MCP-compatible platform — Lovie works with any tool that supports the MCP stdio protocol. Use npx -y lovie as the command, or lovie if installed globally.

That's it. Your AI tool now has access to 79 Lovie business tools.

What You Can Do

Category	Tools
Company Formation	Start formation, set state, choose entity type, check name availability, add shareholders, generate certificate, pay filing fee
Bank Accounts	Create checking/savings/wallet, get balances, freeze/unfreeze, close accounts
Cards	Issue virtual/physical cards, set spending limits, freeze/unfreeze, cancel
Payments	Transfer between accounts, deposit funds, withdraw from wallet
Invoicing	Create/send/duplicate invoices, mark as paid, generate PDFs
Clients	Create and manage client records for invoicing
Transactions	List and filter transactions with AI-powered categorization
Linked Accounts	Connect external bank accounts via Plaid, sync transactions
User Profile	View/update profile, manage sessions, activity history

Commands

lovie              # Show setup instructions
lovie login        # Authenticate with Lovie
lovie logout       # Clear stored credentials
lovie status       # Check authentication status
lovie help         # Show help

How It Works

This package is a lightweight stdio-to-HTTP proxy. It connects your local AI tool to the Lovie MCP server:

AI Tool (Claude, Cursor, etc.)  ←— stdio —→  lovie (this package)  ←— HTTPS —→  Lovie MCP Server

• On startup, discovers all available tools from the remote server
• Forwards tool calls over HTTPS and returns results via stdio
• Handles OAuth authentication, session management, and automatic token refresh
• All business logic runs on the Lovie server — this package is just the bridge

Environment Variables

Variable	Description
LOVIE_MCP_URL	Custom MCP server URL (default: https://mcp.lovie.co/mcp/mcp)
LOVIE_API_KEY	Bearer token — overrides stored OAuth token
DEBUG	Enable verbose logging to stderr

Requirements

• Node.js 18+
• A Lovie account (lovie.co)

License

MIT