How to connect Breezeway to Claude Code, ChatGPT and any AI agent
Yes, Claude, ChatGPT and other AI agents can work in your Breezeway account. Cotlet.dev connects your signed-in Breezeway account to AI agents so you can create, assign, comment on and approve property tasks.
What you can ask
Read tomorrow's Breezeway tasks for Harbor House. Show unassigned tasks and deadlines without changing assignments.
Create a maintenance task for the broken boiler at Harbor House and assign it to Alex.
Show the checklist and comments for the turnover task at Maple Cabin and summarize unresolved items.
Find unassigned cleaning tasks for Friday and propose suitable people without changing assignments.
Approve the completed inspection task for Harbor View after checking its checklist.
Connect in 2 minutes
Get your API key at https://cotlet.dev/app and export it as COTLET_API_KEY.
Claude Code
claude mcp add --transport http cotlet https://cotlet.dev/mcp/v1 --header "Authorization: Bearer $COTLET_API_KEY"
ChatGPT
Settings → Apps → add connector URL https://cotlet.dev/mcp/v1, then sign in with Cotlet.dev. No API key needed.
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 Breezeway 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":{"breezeway":{"command":"uvx","args":["breezeway-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
Or with Docker:
docker build -t breezeway-mcp .
docker run -i --rm -e COTLET_API_KEY breezeway-mcp
Tools: breezeway_guide, breezeway_status, breezeway_open, breezeway_read, breezeway_click, breezeway_type, breezeway_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. From PyPI:
pip install breezeway-mcp # or run it once: uvx breezeway-mcp connect
breezeway-mcp connect
Or straight from this repo:
export COTLET_API_KEY="your-key"
python3 breezeway_agent.py connect # ready config for Claude Code, Cursor, ChatGPT
python3 breezeway_agent.py status # is Breezeway ready in your Cotlet.dev account
python3 breezeway_agent.py guide # Breezeway screens and sign-in link
python3 breezeway_agent.py read # open Breezeway, read the page, close the browser
python3 breezeway_agent.py tools # list Cotlet.dev tools
python3 breezeway_agent.py serve # start the stdio MCP server (same as no argument)
Questions from Breezeway users
Does Breezeway have an API?
Breezeway has a public REST API, but account holders request credentials through its developer form. Cotlet.dev works in your signed-in Breezeway account through a hosted connection, so you do not need a Breezeway API key.
How do I connect Breezeway to ChatGPT?
Add Cotlet.dev in ChatGPT with the connector URL https://cotlet.dev/mcp/v1/connect, sign in to Breezeway once in your Cotlet.dev Cloud Browser, and ask ChatGPT in plain words.
Can I use Claude with Breezeway?
Yes. Add https://cotlet.dev/mcp/v1/connect as a custom connector in Claude, or use the Cotlet MCP server from Claude Code, and Claude can work with your Breezeway account.
Is there a Breezeway MCP server?
Breezeway has no official MCP server listed in its checked developer material. Cotlet.dev is a hosted MCP server that provides 13 Breezeway tools for ChatGPT, Claude and other AI agents.
Find it on
- Breezeway on Cotlet.dev
- PyPI package breezeway-mcp
- Odel
- mcpbeat
- Step-by-step guide (PDF) on Internet Archive
Also works with
Start free: https://cotlet.dev/signup?app=breezeway&utm_source=github&utm_medium=readme&utm_campaign=breezeway