# AccuLynx MCP server

> Integrates the AccuLynx roofing CRM with AI clients to manage jobs, contacts, estimates, and financials.

- Repository: https://github.com/opsrev/acculynx-cli
- Page: https://hostedmcp.org/servers/opsrev/acculynx-cli
- Transport: stdio
- Stars: 0
- License: MIT

## Install

### Claude Code

```sh
claude mcp add acculynx-cli -- npx -y @opsrev/acculynx-cli
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "acculynx-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@opsrev/acculynx-cli"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "acculynx-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opsrev/acculynx-cli"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"acculynx-cli","type":"stdio","command":"npx","args":["-y","@opsrev/acculynx-cli"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "acculynx-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@opsrev/acculynx-cli"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add acculynx-cli -- npx -y @opsrev/acculynx-cli
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.acculynx-cli]
command = "npx"
args = ["-y", "@opsrev/acculynx-cli"]
```

### Gemini CLI

```sh
gemini mcp add -s user acculynx-cli npx -- -y @opsrev/acculynx-cli
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "acculynx-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@opsrev/acculynx-cli"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ACCULYNX_API_KEY` | no | no |  |
| `JOB_ID` | no | no |  |

## Tools (34)

- `acculynx_ping`
- `acculynx_jobs_list`
- `acculynx_jobs_get`
- `acculynx_jobs_create`
- `acculynx_jobs_search`
- `acculynx_jobs_contacts`
- `acculynx_jobs_estimates`
- `acculynx_jobs_financials`
- `acculynx_jobs_invoices`
- `acculynx_jobs_milestones`
- `acculynx_jobs_payments`
- `acculynx_jobs_history`
- `acculynx_jobs_reps`
- `acculynx_jobs_reps_assign`
- `acculynx_jobs_work_types`
- `acculynx_jobs_trade_types`
- `acculynx_jobs_set_work_type`
- `acculynx_jobs_set_trade_types`
- `acculynx_jobs_document_folders`
- `acculynx_jobs_add_expense`
- `acculynx_jobs_upload_document`
- `acculynx_contacts_list`
- `acculynx_contacts_get`
- `acculynx_contacts_create`
- `acculynx_contacts_search`
- `acculynx_contacts_emails`
- `acculynx_contacts_phones`
- `acculynx_contacts_phone_add`
- `acculynx_estimates_list`
- `acculynx_estimates_get`
- `acculynx_estimates_sections`
- `acculynx_estimates_section`
- `acculynx_estimates_items`
- `acculynx_users_list`

## FAQ

### What kind of data can I access through the MCP tools?

You can access 30 different tools covering jobs, contacts, estimates, users, financials, invoices, and more.

### Can I use this as a command line interface?

Yes, the @opsrev/acculynx-cli package provides a JSON CLI for scripting and terminal use.

### Where do I get an API key for AccuLynx?

Your AccuLynx account administrator can create an API key under Account Settings → API.