Iris Works API and MCP server Let your AI agent send the next booking invitation.

Iris Works has no publicly documented API that we could find, and no official Iris Works MCP server was found (checked 11 Nov 2026). Cotlet runs a hosted Iris Works MCP server with 55 tools that ChatGPT and Claude use in your own Iris Works account to send booking invitations and contracts, start session workflows and track invoices.

  • Free 7-day trial, no card
  • Unofficial, not affiliated with Iris Works
Iris Works logo Iris Works Cloud Browser

55 tools Read and write

Photography studio admin

What can your AI agent do in Iris Works? Clients, sessions, contracts, invoices and workflow to-dos for a photography studio.

  • Send a booking invitation with newborn session times

  • Send the contract for a booked wedding

  • Add a session and start its workflow

  • Create and send a session invoice

  • Record a payment a client made by bank transfer

  • Find overdue to-dos on session workflows

No public API found

Does Iris Works have an MCP server or an API? The official Iris Works connection options, checked 11 November 2026.

No publicly documented Iris Works API was found: iris-works.com/api and /developers returned 404 on 11 Nov 2026 and the help center has no API article. Its integrations connect Square, Stripe and PayPal, calendar sync, QuickBooks, Pic-Time and Fundy Designer. No official Iris Works MCP server was found; the "Iris MCP" online belongs to heyiris.ai, a different product.

  • No public Iris Works API documentation or key page was found on 11 Nov 2026.
  • Calendar sync and QuickBooks keep other tools in step; they do not send contracts.
  • Iris Works workflows send preset emails, contracts and invoices on a schedule inside the app.
The Iris Works API, other options and Cotlet compared
What you need Iris Works APIWorkflows in Iris WorksCotlet
Send a booking invitation None found Manual In your account
Send a contract None found Preset steps In your account
Record a payment None found Manual In your account
Ask from ChatGPT or Claude No No Yes

Checked 11 Nov 2026. Sources: Iris Works integrations · Iris Works help center · What is a workflow? · Booking invitations · Send a contract

Set up once

How does the Iris Works MCP server work? The Iris Works MCP server by Cotlet: your agent works in your own Iris Works account.

  1. 1Sign in to Iris Works

    Once, in a browser we host for you.

  2. 2Connect your AI agent

    One address in its settings.

  3. 3Hand it the busywork

    Ask it to send Emma a booking invitation for newborn session times.

Your agent works in your own Iris Works studio account and its client list. Who can see your session

Any MCP client

How to connect Iris Works to your AI agent

  1. 1

    Sign in to Iris Works in a Cloud Browser. Open Iris Works in your Cotlet Cloud Browser and sign in at app.iris-works.com with your own Iris Works login.

  2. 2

    Add the Cotlet address. Enter https://cotlet.dev/mcp/v1 as the MCP server or connector URL in your agent.

  3. 3

    Let the agent in. Chat apps open a Cotlet sign-in page. Editors, n8n and scripts send an API key made in the console.

Iris Works shares the address https://cotlet.dev/mcp/v1 with every other app you enable, so one connector covers them all. Turned Iris Works on after connecting? Refresh the connector and the 55 tools appear.

ChatGPT
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
Claude
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
Cursor
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
Codex
# ~/.codex/config.toml
[mcp_servers.cotlet]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
n8n
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: iris_works_read
11 read, 44 write

All 55 Iris Works MCP tools

Clients6

View Clients, Leads and Marketing Contacts, Add a New Client, Edit a Client Profile and more.

  • list_clients Browse the Clients page, which separates clients, leads and marketing contacts, and open a Client Profile that holds contracts, questionnaires, sessions, invoices, galleries and notes. read

    Browse the Clients page, which separates clients, leads and marketing contacts, and open a Client Profile that holds contracts, questionnaires, sessions, invoices, galleries and notes.

    MCP calliris_works_read → list_clients

    REST endpointGET https://cotlet.dev/api/v1/iris-works/clients

    Parameters

    Parameters: list_clients
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • create_client Create a client profile from the Clients tab using only a name and email, with an option to enroll the client in the email marketing list at creation. writeAsks first

    Create a client profile from the Clients tab using only a name and email, with an option to enroll the client in the email marketing list at creation.

    MCP calliris_works_write → create_client

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/clients

    Parameters

    Parameters: create_client
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Create a client profile from the Clients tab using only a name and email, with an option to enroll the client in the email marketing list at creation.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • update_client Select Edit on an existing profile to add or change client information. write

    Select Edit on an existing profile to add or change client information.

    MCP calliris_works_write → update_client

    REST endpointPATCH https://cotlet.dev/api/v1/iris-works/client

    Parameters

    Parameters: update_client
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Select Edit on an existing profile to add or change client information.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • import_clients_csv Upload a CSV (first_name, last_name, email, phone, email_marketing, client_status required) to bulk-create clients, leads or marketing contacts. Support must enable the feature first. Re-importing an existing client as a marketing contact removes them from the client list. writeAsks first

    Upload a CSV (first_name, last_name, email, phone, email_marketing, client_status required) to bulk-create clients, leads or marketing contacts. Support must enable the feature first. Re-importing an existing client as a marketing contact removes them from the client list.

    MCP calliris_works_write → import_clients_csv

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/clients-csvs

    Parameters

    Parameters: import_clients_csv
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Upload a CSV (first_name, last_name, email, phone, email_marketing, client_status required) to bulk-create clients, leads or marketing contacts. Support must enable the feature first. Re-importing an existing client as a marketing contact removes them from the client list.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • set_client_active_status Use Mark Inactive on a client, or locate the client in the Inactive list and use Mark Active. writeAsks first

    Use Mark Inactive on a client, or locate the client in the Inactive list and use Mark Active.

    MCP calliris_works_write → set_client_active_status

    REST endpointPUT https://cotlet.dev/api/v1/iris-works/client-active-status

    Parameters

    Parameters: set_client_active_status
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Use Mark Inactive on a client, or locate the client in the Inactive list and use Mark Active.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_client_groups Manually assign clients to groups and edit the supplied session-type groups. write

    Manually assign clients to groups and edit the supplied session-type groups.

    MCP calliris_works_write → manage_client_groups

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/client-groups/manage

    Parameters

    Parameters: manage_client_groups
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Manually assign clients to groups and edit the supplied session-type groups.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }

Studio setup and leads4

Configure and Share the Lead Page, Manage Session Types, Create and Edit Email Templates and more.

  • capture_lead_via_lead_page Link to or embed the lead page so inquiries land in the account as leads. A reCAPTCHA field is present. Session types can be flagged for the lead page with an automatic reply per session type. Includes lead-page branding, layout, up to two custom fields and the default autoresponse. writeAsks first

    Link to or embed the lead page so inquiries land in the account as leads. A reCAPTCHA field is present. Session types can be flagged for the lead page with an automatic reply per session type. Includes lead-page branding, layout, up to two custom fields and the default autoresponse.

    MCP calliris_works_write → capture_lead_via_lead_page

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/lead-via-lead-page/capture

    Parameters

    Parameters: capture_lead_via_lead_page
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Link to or embed the lead page so inquiries land in the account as leads. A reCAPTCHA field is present. Session types can be flagged for the lead page with an automatic reply per session type. Includes lead-page branding, layout, up to two custom fields and the default autoresponse.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_session_types Define the session types offered, with an icon (max 10 MB), a calendar label color, lead-page inclusion and an automatic lead reply. write

    Define the session types offered, with an icon (max 10 MB), a calendar label color, lead-page inclusion and an automatic lead reply.

    MCP calliris_works_write → manage_session_types

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/session-types/manage

    Parameters

    Parameters: manage_session_types
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Define the session types offered, with an icon (max 10 MB), a calendar label color, lead-page inclusion and an automatic lead reply.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • manage_email_templates Create reusable 'canned' emails with Variables that pull from the client profile, and attach contracts, invoices, questionnaires and documents. write

    Create reusable 'canned' emails with Variables that pull from the client profile, and attach contracts, invoices, questionnaires and documents.

    MCP calliris_works_write → manage_email_templates

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/email-templates/manage

    Parameters

    Parameters: manage_email_templates
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Create reusable 'canned' emails with Variables that pull from the client profile, and attach contracts, invoices, questionnaires and documents.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • configure_lead_page_redirect Set a custom confirmation URL in the studio profile's Leads settings; leaving it blank uses the default thank-you page. writeAsks first

    Set a custom confirmation URL in the studio profile's Leads settings; leaving it blank uses the default thank-you page.

    MCP calliris_works_write → configure_lead_page_redirect

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/lead-page-redirect/configure

    Parameters

    Parameters: configure_lead_page_redirect
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Set a custom confirmation URL in the studio profile's Leads settings; leaving it blank uses the default thank-you page.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }

Contracts4

Manage Documents Library (Contract Templates, Questionnaire Templates, Attachments), Generate and Send a Contract, Resend an Unsigned Contract and more.

  • manage_documents_library Add contract templates, questionnaire templates and upload attachments in the Documents section. The contract builder takes pasted text, not direct file uploads. Assign an upload to a client, preview, send, update, download or delete; uploads up to 20 MB. writeAsks first

    Add contract templates, questionnaire templates and upload attachments in the Documents section. The contract builder takes pasted text, not direct file uploads. Assign an upload to a client, preview, send, update, download or delete; uploads up to 20 MB.

    MCP calliris_works_write → manage_documents_library

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/documents-library/manage

    Parameters

    Parameters: manage_documents_library
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Add contract templates, questionnaire templates and upload attachments in the Documents section. The contract builder takes pasted text, not direct file uploads. Assign an upload to a client, preview, send, update, download or delete; uploads up to 20 MB.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • send_contract From the client profile, Contracts > Send Contract, choose a template and optional session, Generate, review, then sign and send. The client receives an email link. writeAsks first

    From the client profile, Contracts > Send Contract, choose a template and optional session, Generate, review, then sign and send. The client receives an email link.

    MCP calliris_works_write → send_contract

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/contracts

    Parameters

    Parameters: send_contract
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object From the client profile, Contracts > Send Contract, choose a template and optional session, Generate, review, then sign and send. The client receives an email link.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • resend_contract Use the Resend button on the client's Contracts tab for contracts not yet signed. writeAsks first

    Use the Resend button on the client's Contracts tab for contracts not yet signed.

    MCP calliris_works_write → resend_contract

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/contract/resend

    Parameters

    Parameters: resend_contract
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Use the Resend button on the client's Contracts tab for contracts not yet signed.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • view_client_contracts The Contracts tab in a client profile lists contracts with status labels and last-updated dates, with options to view, resend or download. Signed contracts are stored there. read

    The Contracts tab in a client profile lists contracts with status labels and last-updated dates, with options to view, resend or download. Signed contracts are stored there.

    MCP calliris_works_read → view_client_contracts

    REST endpointGET https://cotlet.dev/api/v1/iris-works/client-contracts/view

    Parameters

    Parameters: view_client_contracts
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }

Invoices, coupons and quotes17

Create an Invoice, Send an Invoice, Add a Payment Schedule to an Invoice and more.

  • create_invoice Create an invoice for a client. The help center covers creating invoices (and drafts), memos and sales tax. write

    Create an invoice for a client. The help center covers creating invoices (and drafts), memos and sales tax.

    MCP calliris_works_write → create_invoice

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoices

    Parameters

    Parameters: create_invoice
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Create an invoice for a client. The help center covers creating invoices (and drafts), memos and sales tax.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • send_invoice Send the invoice to the client from the invoice page with Send Invoice. writeAsks first

    Send the invoice to the client from the invoice page with Send Invoice.

    MCP calliris_works_write → send_invoice

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoices/send-invoice

    Parameters

    Parameters: send_invoice
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Send the invoice to the client from the invoice page with Send Invoice.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • add_invoice_payment_schedule From the invoice's three-dot menu choose Add Payment Schedule: Retainer + Balance, Retainer + Multiple Payments, Multiple Equal Payments, or Custom. Clients are reminded 5 days before and on each due date. Due dates can follow an associated session; resend the invoice after schedule changes so reminders update. writeAsks first

    From the invoice's three-dot menu choose Add Payment Schedule: Retainer + Balance, Retainer + Multiple Payments, Multiple Equal Payments, or Custom. Clients are reminded 5 days before and on each due date. Due dates can follow an associated session; resend the invoice after schedule changes so reminders update.

    MCP calliris_works_write → add_invoice_payment_schedule

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoice-payment-schedules

    Parameters

    Parameters: add_invoice_payment_schedule
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object From the invoice's three-dot menu choose Add Payment Schedule: Retainer + Balance, Retainer + Multiple Payments, Multiple Equal Payments, or Custom. Clients are reminded 5 days before and on each due date. Due dates can follow an associated session; resend the invoice after schedule changes so reminders update.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_invoice_templates Save repeat invoices as templates (products, memo, payment schedule) and use them in workflows or booking calendars. write

    Save repeat invoices as templates (products, memo, payment schedule) and use them in workflows or booking calendars.

    MCP calliris_works_write → manage_invoice_templates

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoice-templates/manage

    Parameters

    Parameters: manage_invoice_templates
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Save repeat invoices as templates (products, memo, payment schedule) and use them in workflows or booking calendars.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • connect_square_payments Under My Settings > Settings > Invoice Setup, connect Square and toggle Tips, ACH (US only), Square Gift Cards, AfterPay and CashApp. When a client pays, the invoice updates to Paid and a receipt is sent automatically. Includes the Apple Pay and Google Pay toggle for Square sellers in the US, Canada, UK and Australia. writeAsks first

    Under My Settings > Settings > Invoice Setup, connect Square and toggle Tips, ACH (US only), Square Gift Cards, AfterPay and CashApp. When a client pays, the invoice updates to Paid and a receipt is sent automatically. Includes the Apple Pay and Google Pay toggle for Square sellers in the US, Canada, UK and Australia.

    MCP calliris_works_write → connect_square_payments

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/square-payments/connect

    Parameters

    Parameters: connect_square_payments
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Under My Settings > Settings > Invoice Setup, connect Square and toggle Tips, ACH (US only), Square Gift Cards, AfterPay and CashApp. When a client pays, the invoice updates to Paid and a receipt is sent automatically. Includes the Apple Pay and Google Pay toggle for Square sellers in the US, Canada, UK and Australia.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • push_invoice_to_quickbooks After connecting QuickBooks Online (US and Canada) in Invoice Setup, use Push To Quickbooks on an invoice. This creates the invoice and, if missing, a new customer in QuickBooks. writeAsks first

    After connecting QuickBooks Online (US and Canada) in Invoice Setup, use Push To Quickbooks on an invoice. This creates the invoice and, if missing, a new customer in QuickBooks.

    MCP calliris_works_write → push_invoice_to_quickbooks

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoice-to-quickbooks/push

    Parameters

    Parameters: push_invoice_to_quickbooks
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object After connecting QuickBooks Online (US and Canada) in Invoice Setup, use Push To Quickbooks on an invoice. This creates the invoice and, if missing, a new customer in QuickBooks.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • send_quote Send a quote to a client; the client can accept, decline or request changes, and an accepted quote becomes an invoice. writeAsks first

    Send a quote to a client; the client can accept, decline or request changes, and an accepted quote becomes an invoice.

    MCP calliris_works_write → send_quote

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/quotes

    Parameters

    Parameters: send_quote
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Send a quote to a client; the client can accept, decline or request changes, and an accepted quote becomes an invoice.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_goals_and_metrics Create goals under My Settings > Settings > Goals and Metrics for sessions, new clients, new leads or billable dollars, tracked daily, weekly, monthly or annually, and shown on the Dashboard under Just the Numbers. write

    Create goals under My Settings > Settings > Goals and Metrics for sessions, new clients, new leads or billable dollars, tracked daily, weekly, monthly or annually, and shown on the Dashboard under Just the Numbers.

    MCP calliris_works_write → manage_goals_and_metrics

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/goals-and-metrics/manage

    Parameters

    Parameters: manage_goals_and_metrics
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Create goals under My Settings > Settings > Goals and Metrics for sessions, new clients, new leads or billable dollars, tracked daily, weekly, monthly or annually, and shown on the Dashboard under Just the Numbers.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • view_dashboard_goal_graph View a line graph of configured goals on the Dashboard. read

    View a line graph of configured goals on the Dashboard.

    MCP calliris_works_read → view_dashboard_goal_graph

    REST endpointGET https://cotlet.dev/api/v1/iris-works/dashboard-goal-graphs/view

    Parameters

    Parameters: view_dashboard_goal_graph
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • manage_coupon_codes Create coupon codes under Invoices > Coupon with amount or percentage, expiry and redemption limits. Only expiry and maximum redemptions can change later; coupons need Square. write

    Create coupon codes under Invoices > Coupon with amount or percentage, expiry and redemption limits. Only expiry and maximum redemptions can change later; coupons need Square.

    MCP calliris_works_write → manage_coupon_codes

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/coupon-codes/manage

    Parameters

    Parameters: manage_coupon_codes
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Create coupon codes under Invoices > Coupon with amount or percentage, expiry and redemption limits. Only expiry and maximum redemptions can change later; coupons need Square.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • refund_invoice_payment Choose Process Refund from an invoice menu, enter the refund amount and optional notes, then submit. Refunds use Square; pending/completed and partial/full refund statuses are documented. writeAsks first

    Choose Process Refund from an invoice menu, enter the refund amount and optional notes, then submit. Refunds use Square; pending/completed and partial/full refund statuses are documented.

    MCP calliris_works_write → refund_invoice_payment

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/invoice-payment/refund

    Parameters

    Parameters: refund_invoice_payment
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Choose Process Refund from an invoice menu, enter the refund amount and optional notes, then submit. Refunds use Square; pending/completed and partial/full refund statuses are documented.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_manually_recorded_payments Record an externally received payment with amount, date and method; optionally send a receipt. Existing recorded payments can also be edited or deleted. This records bookkeeping information, rather than charging a card. writeAsks first

    Record an externally received payment with amount, date and method; optionally send a receipt. Existing recorded payments can also be edited or deleted. This records bookkeeping information, rather than charging a card.

    MCP calliris_works_write → manage_manually_recorded_payments

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/manually-recorded-payments/manage

    Parameters

    Parameters: manage_manually_recorded_payments
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Record an externally received payment with amount, date and method; optionally send a receipt. Existing recorded payments can also be edited or deleted. This records bookkeeping information, rather than charging a card.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • import_fundy_invoice Enable Fundy under Invoice Setup integrations, then use Invoices > Fundy Import, select the client and due date, and upload the Fundy invoice. writeAsks first

    Enable Fundy under Invoice Setup integrations, then use Invoices > Fundy Import, select the client and due date, and upload the Fundy invoice.

    MCP calliris_works_write → import_fundy_invoice

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/fundy-invoices

    Parameters

    Parameters: import_fundy_invoice
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Enable Fundy under Invoice Setup integrations, then use Invoices > Fundy Import, select the client and due date, and upload the Fundy invoice.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • view_invoice_financial_summary Read the current month's invoiced amount, accounts receivable and year-to-date invoiced total in the Invoice section. These are not necessarily cash-received income. read

    Read the current month's invoiced amount, accounts receivable and year-to-date invoiced total in the Invoice section. These are not necessarily cash-received income.

    MCP calliris_works_read → view_invoice_financial_summary

    REST endpointGET https://cotlet.dev/api/v1/iris-works/invoice-financial-summaries/view

    Parameters

    Parameters: view_invoice_financial_summary
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • get_invoice_payment_url Open the invoice menu, select Take Payment Now, and copy the client-view URL. Sending that URL through another channel is a separate, confirmation-requiring communication. read

    Open the invoice menu, select Take Payment Now, and copy the client-view URL. Sending that URL through another channel is a separate, confirmation-requiring communication.

    MCP calliris_works_read → get_invoice_payment_url

    REST endpointGET https://cotlet.dev/api/v1/iris-works/invoice-payment-url

    Parameters

    Parameters: get_invoice_payment_url
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • add_new_product_from_invoice Use Add Product/Service > +Add New, enter product details, and save. This both adds the line item and persists the product in inventory. write

    Use Add Product/Service > +Add New, enter product details, and save. This both adds the line item and persists the product in inventory.

    MCP calliris_works_write → add_new_product_from_invoice

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/new-product-from-invoices

    Parameters

    Parameters: add_new_product_from_invoice
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Use Add Product/Service > +Add New, enter product details, and save. This both adds the line item and persists the product in inventory.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • connect_stripe_or_paypal Connect an existing Stripe or PayPal account for Iris payment processing. writeAsks first

    Connect an existing Stripe or PayPal account for Iris payment processing.

    MCP calliris_works_write → connect_stripe_or_paypal

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/stripe-or-paypal/connect

    Parameters

    Parameters: connect_stripe_or_paypal
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Connect an existing Stripe or PayPal account for Iris payment processing.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }

Calendar4

View the Iris Calendar, Create a Session / Event on the Calendar, Sync an External Calendar and more.

  • view_calendar View sessions and events on the Calendar tab, color-coded by session type. read

    View sessions and events on the Calendar tab, color-coded by session type.

    MCP calliris_works_read → view_calendar

    REST endpointGET https://cotlet.dev/api/v1/iris-works/calendars/view

    Parameters

    Parameters: view_calendar
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • create_session Add a session for a client and attach a workflow, which schedules the workflow's emails and to-dos from the session date. Options exist to create a ShootProof gallery or Pic-Time project at the same time. Workflow emails may send automatically. writeAsks first

    Add a session for a client and attach a workflow, which schedules the workflow's emails and to-dos from the session date. Options exist to create a ShootProof gallery or Pic-Time project at the same time. Workflow emails may send automatically.

    MCP calliris_works_write → create_session

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/sessions

    Parameters

    Parameters: create_session
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Add a session for a client and attach a workflow, which schedules the workflow's emails and to-dos from the session date. Options exist to create a ShootProof gallery or Pic-Time project at the same time. Workflow emails may send automatically.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • connect_external_calendar From the Calendar tab choose Connect Calendars to sync one external calendar (Google, iCal, Outlook, Exchange, Office 365). Iris events appear externally and external events appear in Iris. New sessions made in the external app cannot have a workflow attached. write

    From the Calendar tab choose Connect Calendars to sync one external calendar (Google, iCal, Outlook, Exchange, Office 365). Iris events appear externally and external events appear in Iris. New sessions made in the external app cannot have a workflow attached.

    MCP calliris_works_write → connect_external_calendar

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/external-calendar/connect

    Parameters

    Parameters: connect_external_calendar
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object From the Calendar tab choose Connect Calendars to sync one external calendar (Google, iCal, Outlook, Exchange, Office 365). Iris events appear externally and external events appear in Iris. New sessions made in the external app cannot have a workflow attached.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • view_calendar_event_summary Read an event's associated invoice status/due date, contract signature status, sent questionnaires/emails and upcoming scheduled emails. read

    Read an event's associated invoice status/due date, contract signature status, sent questionnaires/emails and upcoming scheduled emails.

    MCP calliris_works_read → view_calendar_event_summary

    REST endpointGET https://cotlet.dev/api/v1/iris-works/calendar-event-summaries/view

    Parameters

    Parameters: view_calendar_event_summary
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }

Booking6

Create and Publish a Booking Calendar, Add Mini Session Availability with the Mini Scheduler, Configure the Booking Landing Page and more.

  • create_booking_calendar Under My Settings > Settings > Booking Setup, create a public booking calendar: title, introduction, session type, workflow, optional gallery (Pic-Time/ShootProof), location, address requirement, optional contract and invoice, coupon allowance, and availability slots. Publishing makes it bookable by clients, who may sign and pay during booking. writeAsks first

    Under My Settings > Settings > Booking Setup, create a public booking calendar: title, introduction, session type, workflow, optional gallery (Pic-Time/ShootProof), location, address requirement, optional contract and invoice, coupon allowance, and availability slots. Publishing makes it bookable by clients, who may sign and pay during booking.

    MCP calliris_works_write → create_booking_calendar

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/booking-calendars

    Parameters

    Parameters: create_booking_calendar
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Under My Settings > Settings > Booking Setup, create a public booking calendar: title, introduction, session type, workflow, optional gallery (Pic-Time/ShootProof), location, address requirement, optional contract and invoice, coupon allowance, and availability slots. Publishing makes it bookable by clients, who may sign and pay during booking.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • schedule_mini_sessions In a booking calendar's Select Availability tab, use the mini scheduler to generate multiple slots from a date, start time, session count, session length and gap. Changes go live on Publish and Continue. writeAsks first

    In a booking calendar's Select Availability tab, use the mini scheduler to generate multiple slots from a date, start time, session count, session length and gap. Changes go live on Publish and Continue.

    MCP calliris_works_write → schedule_mini_sessions

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/mini-sessions/schedule

    Parameters

    Parameters: schedule_mini_sessions
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object In a booking calendar's Select Availability tab, use the mini scheduler to generate multiple slots from a date, start time, session count, session length and gap. Changes go live on Publish and Continue.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • configure_booking_landing_page Set up a branded landing page showing multiple session types and booking calendars, with images, links and an embed option for your website. writeAsks first

    Set up a branded landing page showing multiple session types and booking calendars, with images, links and an embed option for your website.

    MCP calliris_works_write → configure_booking_landing_page

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/booking-landing-page/configure

    Parameters

    Parameters: configure_booking_landing_page
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Set up a branded landing page showing multiple session types and booking calendars, with images, links and an embed option for your website.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • send_booking_invitation Share specific scheduling options with a client; when they pick one, Iris kicks off the workflow for that session type. The help center lists 'Booking Invitations' as a feature, and says contracts can be attached to booking invitations. The exact UI steps were not retrievable. writeAsks first

    Share specific scheduling options with a client; when they pick one, Iris kicks off the workflow for that session type. The help center lists 'Booking Invitations' as a feature, and says contracts can be attached to booking invitations. The exact UI steps were not retrievable.

    MCP calliris_works_write → send_booking_invitation

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/booking-invitations

    Parameters

    Parameters: send_booking_invitation
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Share specific scheduling options with a client; when they pick one, Iris kicks off the workflow for that session type. The help center lists 'Booking Invitations' as a feature, and says contracts can be attached to booking invitations. The exact UI steps were not retrievable.

    Example input

    {
      "record": "Example client",
      "fields": {
        "session_type": "Newborn session",
        "times": [
          "2026-12-02T10:00",
          "2026-12-04T10:00"
        ]
      }
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • set_event_free_status Select Mark As Free while creating or editing an event so it does not block booking availability. writeAsks first

    Select Mark As Free while creating or editing an event so it does not block booking availability.

    MCP calliris_works_write → set_event_free_status

    REST endpointPUT https://cotlet.dev/api/v1/iris-works/event-free-status

    Parameters

    Parameters: set_event_free_status
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Select Mark As Free while creating or editing an event so it does not block booking availability.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • consider_external_calendar_for_booking In Booking Setup's three-dot menu, enable consideration of external-calendar events. Calendar connection alone does not establish that this conflict checking is enabled. writeAsks first

    In Booking Setup's three-dot menu, enable consideration of external-calendar events. Calendar connection alone does not establish that this conflict checking is enabled.

    MCP calliris_works_write → consider_external_calendar_for_booking

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/external-calendar-for-booking/consider

    Parameters

    Parameters: consider_external_calendar_for_booking
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object In Booking Setup's three-dot menu, enable consideration of external-calendar events. Calendar connection alone does not establish that this conflict checking is enabled.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }

Workflows and To-Dos4

Create, Edit and Apply Workflow Templates, Use 'Edit before Sending' on Workflow Emails, View To-Do Items and more.

  • manage_workflows Build workflows (found at My Settings > Studio > Workflows) of automated emails, documents, contracts, invoices and questionnaires plus your own to-dos, timed relative to the session date. Pre-loaded templates exist. Help articles cover creating, editing and 'Applying Workflow Changes'. writeAsks first

    Build workflows (found at My Settings > Studio > Workflows) of automated emails, documents, contracts, invoices and questionnaires plus your own to-dos, timed relative to the session date. Pre-loaded templates exist. Help articles cover creating, editing and 'Applying Workflow Changes'.

    MCP calliris_works_write → manage_workflows

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/workflows/manage

    Parameters

    Parameters: manage_workflows
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Build workflows (found at My Settings > Studio > Workflows) of automated emails, documents, contracts, invoices and questionnaires plus your own to-dos, timed relative to the session date. Pre-loaded templates exist. Help articles cover creating, editing and 'Applying Workflow Changes'.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • set_workflow_edit_before_sending Have Iris remind you when a workflow email is due so you can review and modify it before it sends. write

    Have Iris remind you when a workflow email is due so you can review and modify it before it sends.

    MCP calliris_works_write → set_workflow_edit_before_sending

    REST endpointPUT https://cotlet.dev/api/v1/iris-works/workflow-edit-before-sending

    Parameters

    Parameters: set_workflow_edit_before_sending
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Have Iris remind you when a workflow email is due so you can review and modify it before it sends.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • view_todos The To-Do tab lists open items, items due today or this week, and completed tasks from workflows and self-created tasks, with search by client name or keyword. read

    The To-Do tab lists open items, items due today or this week, and completed tasks from workflows and self-created tasks, with search by client name or keyword.

    MCP calliris_works_read → view_todos

    REST endpointGET https://cotlet.dev/api/v1/iris-works/todos/view

    Parameters

    Parameters: view_todos
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • create_todo Use the Add button in the To-Do tab to create a standalone task. write

    Use the Add button in the To-Do tab to create a standalone task.

    MCP calliris_works_write → create_todo

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/todos

    Parameters

    Parameters: create_todo
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Use the Add button in the To-Do tab to create a standalone task.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }

Email Marketing4

Create or Save an Email Campaign, Send an Email Campaign to Clients, Filter Clients for a Campaign and more.

  • create_email_campaign On the Email Marketing tab, use New Campaign Template to open the builder (title, description, subject, template or from scratch) and choose Save for Later. Drafts live under My Campaign Templates. Requires the Email Marketing add-on or a plan that includes it. write

    On the Email Marketing tab, use New Campaign Template to open the builder (title, description, subject, template or from scratch) and choose Save for Later. Drafts live under My Campaign Templates. Requires the Email Marketing add-on or a plan that includes it.

    MCP calliris_works_write → create_email_campaign

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/email-campaigns

    Parameters

    Parameters: create_email_campaign
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object On the Email Marketing tab, use New Campaign Template to open the builder (title, description, subject, template or from scratch) and choose Save for Later. Drafts live under My Campaign Templates. Requires the Email Marketing add-on or a plan that includes it.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • send_email_campaign Choose Save and Send to broadcast to the whole list or a filtered segment. Campaigns can also be scheduled ahead of time per vendor marketing pages. Sends to many recipients. writeAsks first

    Choose Save and Send to broadcast to the whole list or a filtered segment. Campaigns can also be scheduled ahead of time per vendor marketing pages. Sends to many recipients.

    MCP calliris_works_write → send_email_campaign

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/email-campaigns/send-email-campaign

    Parameters

    Parameters: send_email_campaign
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Choose Save and Send to broadcast to the whole list or a filtered segment. Campaigns can also be scheduled ahead of time per vendor marketing pages. Sends to many recipients.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • filter_campaign_audience Select clients by criteria for an email campaign, for example clients who booked a family session in the past two years. read

    Select clients by criteria for an email campaign, for example clients who booked a family session in the past two years.

    MCP calliris_works_read → filter_campaign_audience

    REST endpointGET https://cotlet.dev/api/v1/iris-works/campaign-audiences/filter

    Parameters

    Parameters: filter_campaign_audience
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • configure_marketing_optin_form On the Email Marketing page's opt-in form tab, set a welcome message and button color, preview, and embed the form on your website. Submissions go to the Marketing Contacts tab. writeAsks first

    On the Email Marketing page's opt-in form tab, set a welcome message and button color, preview, and embed the form on your website. Submissions go to the Marketing Contacts tab.

    MCP calliris_works_write → configure_marketing_optin_form

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/marketing-optin-form/configure

    Parameters

    Parameters: configure_marketing_optin_form
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object On the Email Marketing page's opt-in form tab, set a welcome message and button color, preview, and embed the form on your website. Submissions go to the Marketing Contacts tab.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }

Scout4

Search Your Locations and Shared Locations in Location Scout, Make a Scout Location Private or Shared, Manage scout location photo and more.

  • browse_scout_locations Search a map of your own locations or choose Shared Locations to see locations other Iris Works users made public, zooming or searching other cities. read

    Search a map of your own locations or choose Shared Locations to see locations other Iris Works users made public, zooming or searching other cities.

    MCP calliris_works_read → browse_scout_locations

    REST endpointGET https://cotlet.dev/api/v1/iris-works/scout-locations/browse

    Parameters

    Parameters: browse_scout_locations
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
  • set_location_visibility Set a location in Location Scout to private (only your studio) or shared (all Iris Works users). Sharing publishes it to other accounts. writeAsks first

    Set a location in Location Scout to private (only your studio) or shared (all Iris Works users). Sharing publishes it to other accounts.

    MCP calliris_works_write → set_location_visibility

    REST endpointPUT https://cotlet.dev/api/v1/iris-works/location-visibility

    Parameters

    Parameters: set_location_visibility
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Set a location in Location Scout to private (only your studio) or shared (all Iris Works users). Sharing publishes it to other accounts.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • manage_scout_location_photo Use New Location or Edit Location to create/edit a location and upload an image. The documented image limit is 10 MB. write

    Use New Location or Edit Location to create/edit a location and upload an image. The documented image limit is 10 MB.

    MCP calliris_works_write → manage_scout_location_photo

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/scout-location-photo/manage

    Parameters

    Parameters: manage_scout_location_photo
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Use New Location or Edit Location to create/edit a location and upload an image. The documented image limit is 10 MB.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved"
    }
  • email_scout_location Choose a location's email icon, select a client, edit the message and send location directions. writeAsks first

    Choose a location's email icon, select a client, edit the message and send location directions.

    MCP calliris_works_write → email_scout_location

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/scout-location/email

    Parameters

    Parameters: email_scout_location
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object Choose a location's email icon, select a client, edit the message and send location directions.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }

Galleries2

Connect Pic-Time and Auto-Create Projects and View a Client's Galleries.

  • connect_pictime In Studio Profile > Gallery Integrations, connect Pic-Time, then check 'Create Pic-Time Project' when creating a session. A 'Pic-Time Gallery Link' variable is available for email templates. writeAsks first

    In Studio Profile > Gallery Integrations, connect Pic-Time, then check 'Create Pic-Time Project' when creating a session. A 'Pic-Time Gallery Link' variable is available for email templates.

    MCP calliris_works_write → connect_pictime

    REST endpointPOST https://cotlet.dev/api/v1/iris-works/pictime/connect

    Parameters

    Parameters: connect_pictime
    NameTypeDescription
    record string required string Record or setting selected in your account.
    fields object required object In Studio Profile > Gallery Integrations, connect Pic-Time, then check 'Create Pic-Time Project' when creating a session. A 'Pic-Time Gallery Link' variable is available for email templates.

    Example input

    {
      "record": "record",
      "fields": "fields"
    }

    Example response

    {
      "example": true,
      "result": "Saved after confirmation"
    }
  • view_client_galleries Open the Galleries tab in a client profile to reach linked ShootProof or Pic-Time galleries. read

    Open the Galleries tab in a client profile to reach linked ShootProof or Pic-Time galleries.

    MCP calliris_works_read → view_client_galleries

    REST endpointGET https://cotlet.dev/api/v1/iris-works/client-galleries/view

    Parameters

    Parameters: view_client_galleries
    NameTypeDescription
    filter string string Record, person, date range or status to review.

    Example response

    {
      "example": true,
      "result": "Records for review"
    }
Encrypted, revocable

Who can see my Iris Works session, and how do I revoke it?

  • What we store

    Your signed-in Iris Works profile, AES-256-GCM encrypted, in Finland. No password.

  • What your agent gets

    The 55 Iris Works tools, never the session cookie.

  • What the session sees

    The leads, clients, sessions, workflows, contracts, quotes and invoices in your Iris Works studio account.

  • What no tool touches

    Your Iris Works subscription, plan and studio profile, gallery creation and delivery, multiple brands on one account, which Iris does not support, and your password.

  • If Iris Works signs you out

    You sign in again yourself, in the same Cloud Browser.

  • How to cut access

    Disable for agents, reset the browser, or change your Iris Works password.

Cotlet never types your password: you sign in yourself, and the agent only uses the session. Our site scores A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory (live results).

Your account

What happens when Iris Works changes? The tools work in your own signed-in Iris Works account.

Cotlet watches the apps it serves and updates the server when Iris Works changes its leads, workflow or invoice screens.

New Iris Works features become available to your agent.

Your Iris Works login determines which leads, clients and sessions it sees.

Cotlet never sees or stores your password. If Iris Works signs you out, open your Cloud Browser with one click from the Cotlet console and sign in again.

30 tools ask first

Approvals, undo and mistakes Clients hear from your studio only after you say so.

  1. 01 Read the client Session type, date and open documents.
  2. 02 Prepare the send Invitation, contract or invoice, ready to review.
  3. 03 You approve Iris Works emails the client.
  4. 04 Track the session Invoices and to-dos follow on the workflow.
Which Iris Works actions can be undone
ActionUndo
Send a booking invitationA sent invitation cannot be recalled
Send a contractA sent email cannot be recalled; resend a corrected contract
Create an invoiceEdit or delete the unsent invoice in Iris Works
Record a paymentEdit or delete the recorded payment in Iris Works

Tools marked Asks first wait for your approval by default; you can switch that off per tool. Unmarked tools run at once.

MCP call
{
  "name": "send_booking_invitation",
  "arguments": {
    "record": "Example client",
    "fields": {
      "session_type": "Newborn session",
      "times": [
        "2026-12-02T10:00",
        "2026-12-04T10:00"
      ]
    }
  }
}
REST
curl -X POST https://cotlet.dev/api/v1/iris-works/booking-invitations \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"record":"Example client","fields":{"session_type":"Newborn session","times":["2026-12-02T10:00","2026-12-04T10:00"]}}'
Response
{
  "invitation": "Sent after confirmation",
  "times": 2
}

A cron job or n8n flow can call the same tools over REST at /api/v1/iris-works with the same key and price, in JSON. Failed calls are free. Each tool row above shows its REST path.

Pay per call

How much does the Iris Works MCP server cost?

About $18 a monthfor a wedding and portrait photographer answering about 6 new inquiries a week, over four weeks, 3,160 credits. Your Iris Works plan stays as it is.

Illustrative month for that photographer: successful calls for this workload
JobCallsCredits
Read new leads and clients 5 days a week1 × 20200
Add 6 new clients a week from inquiries1 × 24240
Send 3 booking invitations a week1 × 12120
Add 3 sessions with workflows a week1 × 12120
Send 2 contracts a week1 × 880
Create and send 2 invoices a week2 × 8160
Record 4 client payments a week1 × 16160
Read the to-do list on 22 workdays1 × 22220
Add 8 to-dos a week1 × 32320
Read the monthly invoice summary1 × 440
Cloud Browser, 30 days1,500
Total3,160

The $29 pack covers a typical month for most owners.

  • Free 7-day trial, no card
  • 10 credits per successful call, MCP or REST
  • 50 credits a day for the Cloud Browser
  • Your Iris Works plan applies.

Illustrative consumption at the smallest credit pack rate, not a subscription or measured usage. Buy credit packs separately; extra calls add usage.

Cotlet credit packs: price, credits and calls at 10 credits each
Credits Price, one time Calls at 10 credits Per 1,000 credits
5,000 $29 500 $5.80
15,000 $79 1,500 $5.27
32,000 $149 3,200 $4.66
60,000 $249 6,000 $4.15

Only successful calls use credits; failed calls and timeouts cost nothing. At a balance of 0 calls pause, never a surprise charge. Authenticate with the Authorization: Bearer header.

Other options

Iris Works MCP server: connection options What else connects Iris Works today, and where each option stops.

Other ways to connect Iris Works, checked 11 Nov 2026
OptionWhat it doesWhere it stops
WorkflowsSend preset emails, contracts and invoices at set points of a sessionRuns your preset steps; cannot answer a new request
Calendar syncShows sessions in iCloud, Google or Outlook calendarsEvents added from the external calendar cannot be edited in Iris
QuickBooksKeeps invoices and payments in your booksAccounting sync only

Cotlet works through your own Iris Works sign-in and handles the invitations, contracts and invoices between your shoots.

EU company, since 2019

Who runs Cotlet A company you can look up.

Take Group sp. z o.o. runs Cotlet. It is a software company registered in Poland, EU (VAT PL6342984273), in business since 2019, led by its founders Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Questions about the Iris Works tools go to contact@cotlet.dev.

Iris Works MCP server: questions

How do I get access?

Start a free Cotlet trial, open Iris Works in your Cloud Browser and sign in at app.iris-works.com with your own Iris Works login. Your agent then gets the 55 Iris Works tools.

How do I connect Iris Works to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Iris Works once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Iris Works account through Cotlet, in their phone apps too.

What can ChatGPT do in Iris Works?

ChatGPT and Claude read your leads, clients and calendar, send booking invitations, contracts and quotes, add sessions with their workflows, create and send invoices, record payments and check workflow to-dos, within your Iris Works account.

Is there an official ChatGPT or Claude app for Iris Works?

No official Iris Works MCP server was found on iris-works.com or in its help center, and no Iris Works listing was verified in the ChatGPT apps or Claude connectors directories (checked 11 Nov 2026). The "Iris MCP" that works with ChatGPT and Claude belongs to heyiris.ai, a different product. Cotlet is an independent MCP server for ChatGPT, Claude and other agents in your signed-in Iris Works account.

Can ChatGPT send a booking invitation in Iris Works?

ChatGPT sends the client a personal set of session dates and times after you approve the invitation; when they pick one, Iris starts that session type's workflow.

Can ChatGPT send a contract in Iris Works?

ChatGPT generates the contract from the template and session you choose and sends it to the client after you approve it.

Can ChatGPT add a session in Iris Works?

ChatGPT adds the session for the client and date you give it and attaches its workflow, after you approve, so the workflow's emails and to-dos are scheduled.

Can ChatGPT create an invoice in Iris Works?

ChatGPT creates the invoice for the client and session you name without sending it; sending it to the client is a separate step you approve.

Can ChatGPT record a payment in Iris Works?

ChatGPT records the amount, date and method of a payment you received outside Iris on the client's invoice after you approve it, with or without a receipt email.

Does Iris Works have an API?

No publicly documented Iris Works API was found on 11 Nov 2026: its /api and /developers pages returned 404 and the help center has no API article. Its integrations are Square, Stripe, PayPal, calendar sync, QuickBooks, Pic-Time and Fundy Designer. Cotlet works through your own Iris Works sign-in.

Is the MCP server different from the REST API?

Only in how it is called. Both carry the same 55 tools, inputs, answers, API key and price. Agents use MCP; scripts and HTTP steps use REST.

Is Cotlet affiliated with Iris Works?

No. Cotlet is independent and not affiliated with Iris Works.

Hand your AI agent the Iris Works client admin

Free 7-day trial with 2,000 credits, no card needed.