# BlueFolder MCP by usefulapi

> BlueFolder MCP by usefulapi is an MCP server. Read customers, equipment and service requests; add service requests and comments in BlueFolder. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/bluefolder/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/bluefolder
- **MCP Registry name:** io.usefulapi/bluefolder
- **Listing updated:** 2026-11-13

## About

Read customers, equipment and service requests; add service requests and comments in BlueFolder.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://bluefolder.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "bluefolder": {
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bluefolder": {
      "type": "http",
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bluefolder": {
      "serverUrl": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bluefolder": {
      "type": "http",
      "url": "https://bluefolder.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `bluefolder_list_customers`: List customers (basic: id, name, type, inactive flag; full: more fields). BlueFolder API: POST /customers/list.aspx.
- `bluefolder_get_customer`: Get one customer with its contacts and locations. Give customerId or externalId. BlueFolder API: POST /customers/get.aspx.
- `bluefolder_list_service_requests`: List service requests (jobs), optionally filtered by customer, status, billing status, invoice or reference number, or a created/closed date range. Use status 'open' for all non-closed requests. BlueFolder API: POST /serviceRequests/list.aspx.
- `bluefolder_get_service_request`: Get one service request with its items, labor, materials, expenses, assignments and billing totals. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/get.aspx.
- `bluefolder_get_service_request_history`: Get the history and comments of one service request. Give serviceRequestId or externalId. BlueFolder API: POST /serviceRequests/getHistory.aspx.
- `bluefolder_list_equipment`: List equipment (assets), optionally for one customer by customerId or customerExternalId. BlueFolder API: POST /equipment/list.aspx.
- `bluefolder_get_equipment`: Get one equipment item with its service dates and notes. BlueFolder API: POST /equipment/get.aspx.
- `bluefolder_list_contracts`: List service contracts, optionally filtered by customer or status. BlueFolder API: POST /contracts/list.aspx.
- `bluefolder_get_contract`: Get one contract with its balances, billing details and limits. BlueFolder API: POST /contracts/get.aspx.
- `bluefolder_list_items`: List catalog items (parts, labor and service items) with unit price and cost. BlueFolder API: POST /items/list.aspx.
- `bluefolder_get_item`: Get one catalog item with its unit price, cost and manufacturer data. BlueFolder API: POST /items/get.aspx.
- `bluefolder_list_users`: List the BlueFolder users (technicians, dispatchers, admins) with their ids and types. BlueFolder API: POST /users/list.aspx.
- `bluefolder_get_user`: Get one BlueFolder user (no password). BlueFolder API: POST /users/get.aspx.
- `bluefolder_list_tax_codes`: List the tax codes and rates set up in the account. BlueFolder API: POST /taxCodes/list.aspx.
- `bluefolder_add_service_request`: Create a new service request (job) for a customer. It sends no customer email unless notifyCustomer is true. BlueFolder API: POST /serviceRequests/add.aspx.
- `bluefolder_add_service_request_comment`: Add a comment to a service request. A public comment with notifyCustomer true emails the customer. BlueFolder API: POST /serviceRequests/addComment.aspx.
- `bluefolder_add_customer_comment`: Add an internal comment to a customer record. BlueFolder API: POST /customers/addComment.aspx.

## FAQ

### How do I add BlueFolder MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http bluefolder https://bluefolder.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/bluefolder-mcp-by-usefulapi
