ERICA Better Proposals MCP Server

MCP server for accessing Better Proposals API.

Required Environment Variables

BETTERPROPOSALS_API_TOKEN=your-api-token-here

How to Get the API Token

1. Log in to your Better Proposals account
2. Go to API Key Generator
3. Click "Generate API Key"
4. Copy the API Key/Token

Tools

| Tool | Description | |------|-------------| | bp_list_proposals | List all proposals (optionally filter by status) | | bp_get_proposal | Get details of a specific proposal | | bp_create_proposal | Create a new proposal | | bp_list_companies | List all companies/clients | | bp_get_company | Get details of a specific company | | bp_create_company | Create a new company/client | | bp_list_quotes | List all quotes | | bp_get_quote | Get details of a specific quote | | bp_create_quote | Create a new quote | | bp_get_settings | Get account settings and merge tags | | bp_list_templates | List available proposal templates |

Installation

npm install -g erica-betterproposals-mcp

Or run via npx:

npx erica-betterproposals-mcp

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "erica-betterproposals": {
      "command": "npx",
      "args": ["-y", "erica-betterproposals-mcp"],
      "env": {
        "BETTERPROPOSALS_API_TOKEN": "your-api-token"
      }
    }
  }
}

API Reference

This MCP uses the Better Proposals API.

Proposal Statuses

• draft - Not yet sent
• sent - Sent to client
• viewed - Client has viewed
• won - Client accepted/signed
• lost - Client declined
• expired - Proposal expired