Ask GorillaDesk (gorilladesk-mcp)

Read-only MCP server so Claude, ChatGPT, or Cursor can answer pest-business questions from your GorillaDesk account in plain English.

It looks things up. It does not create customers, change jobs, or take payments.

Example questions

• How many customers do I have?
• Who owes me money?
• What’s on the schedule this week?
• Who are my technicians?
• How’s money this month?
• Give me a Monday morning briefing

Auth

GorillaDesk uses a company API key (Bearer token).

1. Open Addons → API
2. Generate / copy the key
3. Put it in .env as GORILLADESK_API_KEY (local) or paste it at /connect (hosted)

Docs: https://api.gorilladesk.com/docs/

Local install

cd gorilladesk-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env
# edit .env and paste GORILLADESK_API_KEY

Wire Cursor / Claude Desktop to scripts/run_mcp.sh (see mcp.json.example).

Hosted HTTP

export GORILLADESK_MCP_HOSTED=1
export GORILLADESK_VAULT_SECRET='a-long-random-string'
./scripts/run_mcp_http.sh

Path	Role
/	Landing
/gorilladesk	Product page
/connect	Paste API key → mint bearer token
/mcp	Streamable HTTP MCP
/healthz	Health

Safety

• Client allows GET only
• Tools annotated readOnlyHint=True
• Owner tools return an answer string agents should read aloud

Relay

Product page lives under Relay at /gorilladesk. Marketing host: the relay-mcp Vercel project (fieldwork-mcp landing/).

Builder notes

pytest
ruff check src tests