Iris Works MCP Server
Provides tools for working with an Iris Works account, including reading leads, clients, calendar, and workflow to-dos; managing photography sessions and their workflows; sending booking invitations, contracts, and quotes; and creating or sending invoices and recording payments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Iris Works MCP Server Show my upcoming photography sessions and their workflow to-dos."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Iris Works MCP server for ChatGPT and Claude
Connect Iris Works to ChatGPT, Claude and other AI agents through Cotlet. Work with clients, photography sessions, contracts and invoices in your own signed-in account. Cotlet is independent and not affiliated with Iris Works. If Iris Works offers an official API for your needs, we recommend it.
What you can ask
Show my upcoming photography sessions and their workflow to-dos.
Add a session for the client and date I provide. Ask me before saving.
Create a draft invoice for the client and session I choose. Ask me before saving; do not send it.
Related MCP server: Glasscubes MCP server
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
Claude
Add https://cotlet.dev/mcp/v1 as a custom connector in Claude and sign in with Cotlet.dev. Follow the steps in your Cotlet console.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"Cursor
Copy .cursor/mcp.json from this repo into your project:
{
"mcpServers": {
"cotlet": {
"url": "https://cotlet.dev/mcp/v1",
"headers": {
"Authorization": "Bearer ${COTLET_API_KEY}"
}
}
}
}Run it locally (stdio)
This repo is a real MCP server. It speaks MCP over stdio, lists its Iris Works tools without any key, and forwards every tool call to the hosted Cotlet.dev server. The hosted URL above stays the recommended way. Use this when your client only starts local servers.
{"mcpServers": {"iris-works": {"command": "python3", "args": ["/absolute/path/to/iris-works-mcp/iris_works_agent.py", "serve"], "env": {"COTLET_API_KEY": "your-key"}}}}Or with Docker:
docker build -t iris-works-mcp .
docker run -i --rm -e COTLET_API_KEY iris-works-mcpTools: iris_works_guide, iris_works_status, iris_works_open, iris_works_read, iris_works_click, iris_works_type, iris_works_close. Without COTLET_API_KEY a tool call answers: "Set COTLET_API_KEY. Get a key at https://cotlet.dev/app".
Command line
Python 3.10+, nothing else to install. Run from this repo:
export COTLET_API_KEY="your-key"
python3 iris_works_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 iris_works_agent.py status # is Iris Works ready in your Cotlet.dev account
python3 iris_works_agent.py guide # Iris Works screens and sign-in link
python3 iris_works_agent.py read # open Iris Works, read the page, close the browser
python3 iris_works_agent.py tools # list Cotlet.dev tools
python3 iris_works_agent.py serve # start the stdio MCP server (same as no argument)Questions from Iris Works users
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.
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.
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 Cotlet affiliated with Iris Works?
No. Cotlet is independent and not affiliated with Iris Works.
Find it on
Request access: https://cotlet.dev/signup?app=iris-works&utm_source=github&utm_medium=readme&utm_campaign=iris-works
Available Tools
7 toolsiris_works_clickB
Click a numbered element on the current Iris Works page.
Inputs: element (required).
iris_works_closeA
Close the Iris Works browser session when the work is done, so credits stop running.
Inputs: no named parameters.
iris_works_guideA
How to work in Iris Works (review clients, schedule sessions and prepare invoices): its screens and the sign-in link. Call this first.
Inputs: task.
iris_works_openA
Open a Iris Works page in your signed-in Cloud Browser (default https://app.iris-works.com) to work with review clients, schedule sessions and prepare invoices.
Inputs: url.
iris_works_readA
Read the current Iris Works page: its text and numbered buttons, links and fields.
Inputs: element.
iris_works_statusA
Check that your Cotlet.dev account and Iris Works are ready: account, credits and Iris Works connection.
Inputs: no named parameters.
iris_works_typeB
Type text into a numbered field on the current Iris Works page.
Inputs: text (required), element (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a distinct role in a browser-automation workflow: guide, readiness check, open, read, click, type, and close. There is little risk of confusing one tool with another.
All tools use the same iris_works_ prefix and snake_case convention. The suffixes mix action verbs (open, read, click, type, close) with noun-like helpers (guide, status), but the pattern remains highly readable.
Seven tools is well-scoped for a browser-automation server. Each tool supports a necessary step in the session lifecycle, with no obvious filler.
The core loop is covered: check readiness, open a page, inspect it, click, type, and close. Some advanced browser operations such as scrolling, waiting, or navigation to arbitrary URLs may be missing, but basic workflows are supported.
Maintenance
Related MCP Connectors
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Connect ChatGPT and Claude to Fortnox: invoices, customers, reports. Every write needs your OK.
ShootProof MCP server for ChatGPT, Claude and any AI agent: create gallery, share gallery, list orders, send contract and send invoice in your own ShootProof account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to ShootProof yourself; Cotlet does not store your password and you need no ShootProof API key. About the official ShootProof API: ShootProof has a documented OAuth API that is free with an account, but you get a client ID only by emailing ShootProof support with your app details (checked 8 Nov 2026). There is no self-service key and no official MCP server. Setup and FAQ: https://cotlet.dev/integrations/shootproof-api-mcp-server
Pixieset MCP server for ChatGPT, Claude and any AI agent: create gallery, upload photos, send invoice, list bookings and add client in your own Pixieset account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Pixieset yourself; Cotlet does not store your password and you need no Pixieset API key. About the official Pixieset API: Pixieset has no public API, no webhooks and no Zapier app (checked 11 Oct 2026). Its Apps & Plugins page lists the Lightroom plugin, the Studio Manager mobile app and Photo Editor, and no developer program. Setup and FAQ: https://cotlet.dev/integrations/pixieset-api-mcp-server
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage WordPress posts, pages, media, taxonomies, comments, users, settings, and custom fields through the WordPress REST API. Supports secure authentication, OAuth deployment, search, and safe write controls.MIT
- AlicenseAqualityCmaintenanceLets AI assistants connect securely to a professional-services client portal to review workspaces, outstanding document requests, tasks, file and folder metadata, members, and calendar events, plus optionally create tasks and update their states when writes are allowed.11MIT
- AlicenseNot gradedqualityBmaintenanceConnects AI assistants to a business workspace so they can read and manage clients, leads, projects, tasks, tickets, invoices, proposals, and related records, including sending client emails.1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to manage a user's own SmugMug account in plain language — creating and securing galleries, auditing visits, renaming and organizing photos, and applying price lists — without needing a SmugMug API key, OAuth setup, or code.7Elastic 2.0