@actualjob/mcp-server

MCP server for actual-job.com — the agent-first analyzer that reverse-engineers what someone actually does from their work accounts (Calendar + Gmail in v1; Asana + HubSpot in v1.1).

Registers all jd_* tools (estimate analysis, validate consent, start, get status, get description, refine, list/delete, audit log) and proxies them to the Tool Gateway at api.actual-job.com. Stdio transport for local agents (Claude Desktop, Cursor, Windsurf). HTTP+SSE transport for remote agents lives in the same repo.

Install

# No install — invoke directly via npx (recommended for MCP hosts):
npx -y @actualjob/mcp-server

# Or install globally:
npm install -g @actualjob/mcp-server

The npx form is what most MCP hosts expect: it fetches the latest and streams over stdio in one line. If you install globally you get actualjob-mcp (and the legacy alias jd-mcp-server) on your PATH.

Use with Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "actualjob": {
      "command": "npx",
      "args": ["-y", "@actualjob/mcp-server"],
      "env": {
        "ACTUALJOB_AGENT_TOKEN": "agent_..."
      }
    }
  }
}

Get your ACTUALJOB_AGENT_TOKEN from the actual-job.com dashboard.

Use with Cursor / Windsurf

Same shape — point your IDE's MCP config at actualjob-mcp and pass ACTUALJOB_AGENT_TOKEN.

Configuration

| Env var | Default | Purpose | |---|---|---| | ACTUALJOB_AGENT_TOKEN | (required) | Per-agent scoped token. Issue from the dashboard. | | ACTUALJOB_GATEWAY_URL | https://api.actual-job.com | Override for staging / local dev. |

Tools surfaced

All 20 jd_* tools defined by @actualjob/contract. Run actualjob-mcp and the host agent will list them via tools/list.

Repo

Source: https://github.com/capitalthought/actualjob

License

MIT