# Joist MCP Server and API by Cotlet

Joist MCP Server and API by Cotlet — an MCP server for Claude Code that connects AI assistants to Joist for managing estimates and invoices.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: cotletdev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cotletdev/joist-api-mcp-server
- Updated: 2026-11-10
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/joist-mcp-server-and-api-by-cotlet

## What it does

The server bridges AI agents and Joist via 20 built-in tools to fill the gap of lacking public APIs. It reads your Google Chrome session locally on Python 3.11+ to handle customer records, draft estimates, convert them into invoices, record payments, and export CSV reports.

Installation runs via terminal using `uv tool install joist-api-mcp` or `pip install joist-api-mcp`. The setup requires Python and an active Google Chrome session on your machine to function properly.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://cotlet.dev/mcp/v1/joist/connect`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http joist https://cotlet.dev/mcp/v1/joist/connect
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add joist-mcp-server-and-api-by-cotlet --url https://cotlet.dev/mcp/v1/joist/connect
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "joist-mcp-server-and-api-by-cotlet": {
            "url": "https://cotlet.dev/mcp/v1/joist/connect"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "joist-mcp-server-and-api-by-cotlet": {
            "type": "http",
            "url": "https://cotlet.dev/mcp/v1/joist/connect"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http joist-mcp-server-and-api-by-cotlet https://cotlet.dev/mcp/v1/joist/connect
```

## When to use it
- draft an estimate from text description
- convert approved estimates to invoices
- record customer payments
- list overdue invoices and drafts

## Example prompts
- Write an estimate for Maple Street Dental
- Generate invoices for approved estimates
- Record the payment on invoice 1042

## Similar
- [BookingKoala by Cotlet](https://affpapa.org/en/nevibecode/mcp/bookingkoala-by-cotlet.md) — MCP server · ★ 6 repo stars
- [Exchange Rate API](https://affpapa.org/en/nevibecode/mcp/exchange-rate-api.md) — MCP server · 273 installs
- [api-testing](https://affpapa.org/en/nevibecode/skills/api-testing.md) — skill · 1800 installs
- [reverse-api-engineer](https://affpapa.org/en/nevibecode/skills/reverse-api-engineer.md) — skill · 1400 installs
- [API Deprecation and Sunset Plan Builder (YAML)](https://affpapa.org/en/nevibecode/prompts/api-deprecation-and-sunset-plan-builder-yaml.md) — prompt · ★ 178201 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
