# Agency Handy

MCP server connecting Claude Code, Cursor, Copilot and other clients to Agency Handy CRM.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: AgencyHandy
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AgencyHandy/agencyhandy-mcp
- Updated: 2026-10-11
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/agency-handy

## What it does

Hosted by Agency Handy at `https://mcp.agencyhandy.com/` — nothing to install locally. Sign in with Agency Handy (OAuth 2.1 with PKCE) or use an API key from workspace settings.

Provides tools prefixed with `ah_`: read clients, leads, projects, tasks, tickets, comments, invoices, proposals, orders, subscriptions, services, forms and custom fields; create and update leads, clients, tasks, tickets, comments, invoices, proposals and orders; send invoices and proposals by email to clients; analytics (`ah_dashboard_digest`, `ah_cash_risk`, `ah_client_churn_risk`). Start a session with `ah_health`; the data model is in the `ah://full-context` resource.

Everything operates with the permissions of the person who authenticated, in the chosen workspace. Tools that send emails and delete data change real customer information — review commands before confirming. The server does not store workspace data, only short request logs (tool name, duration, member and workspace identifiers, IP, errors without keys) for up to 14 days.

## Requirements
- Remote server: `https://mcp.agencyhandy.com/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.agencyhandy.com/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add agency-handy --url https://mcp.agencyhandy.com/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agency-handy": {
            "url": "https://mcp.agencyhandy.com/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agency-handy": {
            "type": "http",
            "url": "https://mcp.agencyhandy.com/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http agency-handy https://mcp.agencyhandy.com/
```

## When to use it
- pull clients, projects and tasks from Agency Handy into an agent
- create an invoice, proposal or lead through an AI agent
- find overdue invoices and clients at risk of churn
- email an invoice or proposal to a client from an agent command
- update a task or ticket status from the IDE

## Example prompts
- Show all clients with overdue invoices using `ah_cash_risk`
- Create a task in the Redesign project with a Friday deadline
- Email invoice 1024 to the client

## Similar
- [FavCRM — Agentic CRM](https://affpapa.org/en/nevibecode/mcp/favcrm-agentic-crm.md) — MCP server · 8514 installs
- [Onplana](https://affpapa.org/en/nevibecode/mcp/onplana.md) — MCP server · ★ 5 repo stars
- [Workast](https://affpapa.org/en/nevibecode/mcp/workast.md) — MCP server · ★ 1 repo stars
- [quote-to-cash](https://affpapa.org/en/nevibecode/skills/quote-to-cash.md) — skill · 1800 installs
- [mycase-mcp](https://affpapa.org/en/nevibecode/mcp/mycase-mcp.md) — MCP server · ★ 6 repo stars
- [QuickBooks Online](https://affpapa.org/en/nevibecode/mcp/quickbooks-online.md) — MCP server · ★ 14 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
