Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http mcp https://mcp.agencyhandy.com/
Open on GitHub

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/

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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open