Your AI already knows
how to talk to Roomie.
Roomie runs an MCP server. If your AI speaks MCP, it can read your tasks, messages, email and calendar itself, and write back. No plugins, no API keys to manage.
claude mcp add --transport http roomie-workspace \
https://app.roomie.work/v1/api/mcpAuthorise with your Roomie account in the browser window it opens. That is the whole setup.
It reads the work, and it can change it
Ask what happened with a deal this week and it reads the messages, the tickets and the mail before answering. It writes too, so a wiki page is something it edits rather than hands you to paste.
- Tasks, boards, sprints and releases
- Channels, threads and direct messages
- Email, with threads and attachments
- Wiki spaces and pages, down to one section
- Website pages and posts, including publishing
- Calendar, and full-text search across all of it
Sentences people actually type
Nothing is pasted in first. The agent opens the tools it needs and answers, which is the difference between an assistant that reads your work and one that reads your clipboard.
- “Plan the implementation for ROOMIE-167” reads the ticket, the related chat and the client's mail
- “Create a task from the last support email” opens it on the right board and links the thread
- “Brief me on Acme before my 2pm” pulls two weeks of messages, open tickets and the contract
It sees exactly what you see
Authentication is OAuth against your own Roomie account, so there are no API keys to leak. Private channels, direct messages and restricted projects stay invisible unless you already have access, and revoking the connection in settings cuts the agent off immediately.
- No API keys, and nothing to rotate
- The same permission model as the rest of the workspace
- On every plan, including the free one, with no add-on fee
MCP, against automating it yourself
Both are reasonable. They solve different problems, and the difference is who decides what gets fetched.
What to do for the one you use
Sign in to Roomie in the same browser first, so the authorisation step has something to authorise against.
- Claude Code
- The terminal command above.
- Codex
- The same command, with codex in place of claude.
- Kimi
- The same command again.
- ChatGPT
- Settings, then Connectors, then paste https://app.roomie.work/v1/api/mcp.
- Cursor
- A short JSON block in the MCP config file.
- Antigravity
- Add it as an HTTP MCP server with the same URL.
- Anything else
- A generic JSON config covers any compliant client.
If the client does not pick the server up: most read their config only at startup, so restart it. If the authorisation window never appeared, allow pop-ups for app.roomie.work and run the command again. And if the AI answers without using the tool, ask it explicitly to use the roomie-workspace tool. Tell us if it still will not connect.
MCP, answered
What is MCP?
MCP stands for Model Context Protocol. It's an open standard introduced by Anthropic in late 2024 that lets an AI agent read live data from an external app on its own, instead of relying on what you paste into the chat. Roomie runs an MCP server, so any MCP-compatible AI can query your tasks, messages, emails, and calendar directly.
Which AI agents can I connect?
Anything that speaks MCP. Today that includes Claude Code, Codex, ChatGPT, Cursor, Kimi and Antigravity; a generic JSON config covers everything else. When a new MCP client ships it works with Roomie automatically. Nothing to update on your side.
Do I need to be a developer to set this up?
No. For Claude Code, Codex and Kimi it is a single terminal command. For ChatGPT it is pasting a URL into Settings, and for Cursor a short JSON block in a config file. Most people are connected in under two minutes.
Is my data safe? What can the AI actually read?
The AI only sees what you, the logged-in user, can see. Authentication happens over OAuth with your Roomie account, no API keys to manage or leak. The AI cannot send messages, delete data, or act on your behalf unless you explicitly ask it to and approve the action.
Can I limit which data the AI sees?
Yes. The AI respects the same permission model as the rest of Roomie: private channels, DMs, and restricted projects are invisible to it unless the authenticated user has access. You can also revoke an MCP connection from the settings page at any time, which immediately cuts off the agent.
How is this different from Zapier or a custom integration?
Zapier runs deterministic workflows. You define triggers and actions in advance. MCP is the opposite: the AI decides what to look up, when, based on your question. No automations to design. You ask something, the AI figures out which Roomie tool to call and does it.
Does this only work with Claude?
No. MCP is model-agnostic. Roomie works equally well with Claude, Codex, ChatGPT, Cursor, Kimi, and any future client that supports the protocol. You pick the model based on cost, speed, or capability; Roomie just provides the data.
What Roomie plan do I need?
Every plan, including the free one. There is no add-on fee and no separate subscription: what differs between plans is the monthly AI token allowance, not whether your own agent may connect.
Does it work offline or self-hosted?
Both. The hosted server runs at app.roomie.work, and a self-hosted instance runs its own MCP endpoint on your domain alongside the rest of the workspace, so an agent can reach it without anything leaving your network.
How do I know the connection is working?
After authorizing, ask your AI something like "summarize my open tasks" or "what did the team discuss in #product yesterday?" If it returns real data from your workspace, you're connected. If it asks you to paste things in, it did not pick up the server; re-run the command and restart the client.
The rest of the workspace
Every one of these is included, and they all know about each other.
A PM, sales rep or marketer that asks, then acts
Team chatThreads, huddles, and messages that become tickets
Custom domain emailUnlimited mailboxes on your own domain
CRMDeals, a shared inbox, quotes and invoices
Tasks & ticketingSprints, boards, releases and ticket types
Virtual officeSee who's around and walk up to them
Customer supportAn embeddable widget and a shared inbox
Website builderShip a site and a blog on your own domain
Wiki & docsSpaces, pages and live co-editing
AI that read your workAnswers with sources, from every surface
Coding agentReads your repo, shows the diff, runs the check
Stop pasting context into chats
Connect your AI to Roomie and it looks things up itself. Free for three people, and MCP is on every plan.