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

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