Skip to content
MCP server

Boulevard MCP by usefulapi

Look up appointments, clients, services, staff and orders, and update clients in…

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Boulevard MCP by usefulapi

Boulevard MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Look up appointments, clients, services, staff and orders, and update clients in Boulevard.

Install

Run in a terminal

claude mcp add --transport http boulevard https://boulevard.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://boulevard.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "boulevard": {
      "url": "https://boulevard.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "boulevard": {
      "type": "http",
      "url": "https://boulevard.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "boulevard": {
      "serverUrl": "https://boulevard.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "boulevard": {
      "type": "http",
      "url": "https://boulevard.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (21)

Read directly from the server.

boulevard_get_business
Fetch the Boulevard business the credentials act for — name, timezone, address, phone, website. A cheap way to confirm the setup works. GraphQL: business.
boulevard_list_locations
List the business's locations with id, name, timezone and address. Most other tools need a location id from here. GraphQL: locations.
boulevard_list_appointments
List appointments at one location, optionally for one client and filtered by a query such as a date range or staff member. Each appointment includes its client, services, staff, state and cancellation. GraphQL: appointments.
boulevard_get_appointment
Fetch one appointment by id — time, state, notes, client, each booked service with its staff and price (in cents), cancellation details and tags. GraphQL: appointment.
boulevard_list_clients
List the business's clients, or find them by email, id list, or a query (e.g. name = 'Jane Doe', mobilePhone = '+15551234567'). GraphQL: clients.
boulevard_get_client
Fetch one client by id, including contact details, appointment count, account balance (cents), scheduling alert, tags and notes. GraphQL: client.
boulevard_list_services
List the service menu — name, category, default duration (minutes) and default price (cents), and whether it is an add-on. GraphQL: services.
boulevard_list_staff
List staff members with their role, locations, contact details and whether they are bookable online, optionally filtered by a query. GraphQL: staff.
boulevard_list_shifts
List staff working shifts at one location for a date range — clock-in/out times, weekday, availability and recurrence. GraphQL: shifts.
boulevard_list_timeblocks
List blocked time on staff calendars at one location (breaks, meetings, personal time). GraphQL: timeblocks.
boulevard_list_orders
List checkout orders at one location with totals (cents: subtotal, discount, tax, gratuity, total, refunds), optionally filtered e.g. by closedAt range or clientId. GraphQL: orders.
boulevard_get_order
Fetch one order by id with its totals and line items (services, products, gratuity, gift cards), amounts in cents. GraphQL: order.
boulevard_list_products
List retail products — brand, SKU, barcode, unit price and cost (cents), category. Set include_inactive to include retired products. GraphQL: products.
boulevard_list_memberships
List client memberships sold by the business — status (ACTIVE, PAUSED, PAST_DUE, CANCELLED), client, price (cents), interval, term and next charge date. GraphQL: memberships.
boulevard_list_tags
List the tags defined for the business (ids to use with boulevard_add_tag). GraphQL: tags.
boulevard_create_client
Create a new client profile. Check boulevard_list_clients by email or phone first to avoid a duplicate. GraphQL: createClient.
boulevard_update_client
Change a client's name, email, mobile phone, date of birth, pronoun or external id. Only the fields you pass change. GraphQL: updateClient.
boulevard_create_client_note
Add an internal note to a client's profile (visible to staff, e.g. formulas, preferences, allergies). GraphQL: createClientNote.
boulevard_update_appointment
Replace an appointment's internal notes and/or move its state to BOOKED, CONFIRMED, ARRIVED or ACTIVE (e.g. confirm, or check the client in). Does not cancel or reschedule. GraphQL: updateAppointment.
boulevard_create_timeblock
Block time on one staff member's calendar at a location (a break, meeting or personal time) so it cannot be booked. One-off only. GraphQL: createTimeblock.
boulevard_add_tag
Apply an existing tag (from boulevard_list_tags) to a taggable record such as a client or appointment. GraphQL: addTag.

Boulevard MCP by usefulapi FAQ

How do I add Boulevard MCP by usefulapi to Claude Code?

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