Agency Handy — Claude Code MCP server: what it does, how to install
MCP server connecting Claude Code, Cursor, Copilot and other clients to Agency Handy CRM.
MIT ★ 1 updated 2026-10-11
claude mcp add --transport http mcp https://mcp.agencyhandy.com/What Agency Handy 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.
What it helps with
- 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 for the agent
- 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
How to install Agency Handy
Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.agencyhandy.com/Platform CLI: remote server
codex mcp add agency-handy --url https://mcp.agencyhandy.com/Config file
{
"mcpServers": {
"agency-handy": {
"url": "https://mcp.agencyhandy.com/"
}
}
}Config file
{
"servers": {
"agency-handy": {
"type": "http",
"url": "https://mcp.agencyhandy.com/"
}
}
}Platform CLI: remote server
gemini mcp add -t http agency-handy https://mcp.agencyhandy.com/Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Agency Handy
How do I install Agency Handy in Claude Code?
Run claude mcp add --transport http agency-handy https://mcp.agencyhandy.com/, then run /mcp and select Authenticate to sign in with Agency Handy.
What does Agency Handy do?
Connects an AI agent to your Agency Handy workspace. The agent can read clients, projects, tasks, invoices and proposals, create and update them, send documents to clients, and analyze risks from overdue invoices and client churn.
Do I need an API key to use Agency Handy?
OAuth sign-in is recommended: add the server URL, sign in to Agency Handy, pick the workspace and grant access. An API key is only needed for clients without OAuth support — generate it under Settings → Workspace Config → API Key and pass it in the Authorization: Bearer YOUR_API_KEY header.