Skip to main content

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.

Run in your terminal
claude mcp add --transport http roomie-workspace \
  https://app.roomie.work/v1/api/mcp

Authorise with your Roomie account in the browser window it opens. That is the whole setup.


Reach

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
In practice

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
Permissions

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

Honestly

MCP, against automating it yourself

Both are reasonable. They solve different problems, and the difference is who decides what gets fetched.

Roomie
Zapier or a custom build
Who decides what to fetch
The AI does, from your question.
You do, in advance, as triggers and actions.
Where it runs
Your terminal, your editor, your AI app.
Inside the vendor's product, with the vendor's model.
When a new model ships
It works, because the protocol is open.
You wait for the vendor, or rebuild the glue.
What breaks it
Little. The server advertises its own tools.
A renamed field, an expired key, a changed API.

Clients

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.

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.