# 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

```bash
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:

```json
{
  "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.

```json
{"mcpServers":{"breezeway":{"command":"uvx","args":["breezeway-mcp"],"env":{"COTLET_API_KEY":"your-key"}}}}
```

Or with Docker:

```bash
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:

```bash
pip install breezeway-mcp        # or run it once: uvx breezeway-mcp connect
breezeway-mcp connect
```

Or straight from this repo:

```bash
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](https://cotlet.dev/integrations/breezeway-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=breezeway&utm_content=find)
- [PyPI package breezeway-mcp](https://pypi.org/project/breezeway-mcp/)
- [Odel](https://odel.app/modules/cotlet/breezeway)
- [mcpbeat](https://mcpbeat.com/mcp-servers/cotlet/breezeway/)
- [Step-by-step guide (PDF) on Internet Archive](https://archive.org/details/cotlet-connect-breezeway-to-ai-agents-guide)

## Also works with


- [All apps connected through Cotlet.dev](https://github.com/cotlet-connect)

---

More: https://cotlet.dev/integrations/breezeway-api-mcp-server?utm_source=github&utm_medium=readme&utm_campaign=breezeway

Start free: https://cotlet.dev/signup?app=breezeway&utm_source=github&utm_medium=readme&utm_campaign=breezeway