Roomwork MCP Server · Connect Claude and AI Apps to Your Rooms

Q: What is the roomwork MCP server?

It is a remote Model Context Protocol server at https://roomwork.co/mcp. It lets an MCP app such as Claude list the rooms you can use, read recent messages and file names, and post messages, all as you and within your permissions.

Q: Which commands does it support?

Twelve: list_rooms, send_message, list_messages, read_message, list_files, list_projects, list_clients, list_tasks, get_task, create_task, update_task and add_task_comment. The read commands are offered to Workspace admins and Paying.co staff only. Projects, clients and tasks are limited to the projects of the rooms you ticked.

Q: Can an AI app message my clients by accident?

No. When a room includes clients, send_message requires an audience of shared (clients can see it) or team (team only), and the app is told to ask you if you have not said.

Q: Can it read file contents?

No. list_files returns names, types, sizes, who uploaded each file, when, any note and a link to open it in roomwork. File contents are not sent to the AI app.

Connect

Set it up in a minute

Shown for Claude. Other MCP apps use the same address.

Open Settings, then Connectors in Claude and choose to add a custom connector.
Name it Roomwork and enter the server address https://roomwork.co/mcp.
Claude opens the roomwork sign-in page. Sign in and approve the connection. No password or key is pasted into Claude.
Ask Claude about a room, for example: list my roomwork rooms.

Connection details for developers: protected resource metadata at /.well-known/oauth-protected-resource, authorization server metadata at /.well-known/oauth-authorization-server, authorization code flow with S256 PKCE, dynamic client registration at /oauth/register.

Supported commands

Twelve commands, one for each job

Start with list_rooms to get a room id, then use it with any other command.

list_roomsEveryoneRead only

Lists the rooms this connection may use: room id, name, project, and whether clients (people outside the team) are in the room. Call this first to find a room id.

No parameters.

Limit: 60 per minute, 600 per hour

send_messageEveryoneWrites a message

Posts a text message in a room. It appears under the name of the person who connected the app. If the room has clients, audience is required. Text only, no attachments.

Parameter	Type	Needed	Notes
room_id	string	Required	A room id from list_rooms.
body	string	Required	The message text, up to 8000 characters.
audience	shared \| team	When clients are in the room	shared lets clients see it, team keeps it to the team.

Limit: 20 per minute, 300 per hour

list_messagesAdmins and Paying.co staffRead only

Lists recent messages in a room, oldest first: id, author, time, text, audience (shared or team), any attached file and a link to open it. Long text is cut at about 4000 characters and marked truncated.

Parameter	Type	Needed	Notes
room_id	string	Required	A room id from list_rooms.
limit	integer 1 to 100	Optional	How many messages. Default 30.
before	ISO time	Optional	Only messages older than this. Use next_before from the previous result to page back.

Limit: 30 per minute, 300 per hour

read_messageAdmins and Paying.co staffRead only

Reads one message in full, for example a long forwarded email that list_messages cut short. Returns the same fields plus a link that opens it in roomwork.

Parameter	Type	Needed	Notes
room_id	string	Required	A room id from list_rooms.
message_id	string	Required	A message id from list_messages.

Limit: 60 per minute, 600 per hour

list_filesAdmins and Paying.co staffRead only

Lists the files in a room, newest first: name, type, size, uploader, date, note, the message it was posted with and a link. Metadata only, never file contents.

Parameter	Type	Needed	Notes
room_id	string	Required	A room id from list_rooms.
q	string	Optional	Text to match in the file name.
limit	integer 1 to 100	Optional	How many files. Default 30.
before	ISO time	Optional	Only files older than this. Use next_before to page back.

Limit: 30 per minute, 300 per hour

list_projectsAdmins and Paying.co staffRead only

Lists the projects this app can reach, meaning the projects of the rooms you ticked: id, title, client, status and task count.

Parameter	Type	Needed	Notes
q	string	Optional	Text to match in the project or client name.

Limit: 30 per minute, 300 per hour

list_clientsAdmins and Paying.co staffRead only

Lists the clients behind those projects and how many of their projects the app can reach.

Limit: 30 per minute, 300 per hour

list_tasksAdmins and Paying.co staffRead only

Lists tasks in those projects, most recently changed first, and returns the status keys you can use when creating or updating tasks. Open tasks only unless you ask for closed ones.

Parameter	Type	Needed	Notes
project_id	string	Optional	A project id from list_projects.
status	string	Optional	A status key, for example new or completed.
assignee	string	Optional	The word me, or an email address.
q	string	Optional	Text to match in the task title.
include_closed	boolean	Optional	Also show completed and cancelled tasks.
limit / offset	integers	Optional	Page through results. Default 30, up to 100.

Limit: 30 per minute, 300 per hour

get_taskAdmins and Paying.co staffRead only

Reads one task in full: status, priority, due date, percent done, assignees and its latest 30 comments.

Parameter	Type	Needed	Notes
task_id	string	Required	A task id from list_tasks.

Limit: 60 per minute, 600 per hour

create_taskEveryoneCreates a task

Creates a task in one of those projects as the person who connected the app, so that person's normal project permissions apply.

Parameter	Type	Needed	Notes
project_id	string	Required	A project id from list_projects.
title	string	Required	Up to 300 characters.
status / priority	strings	Optional	Keys from list_tasks. Status defaults to new.
due_date	string	Optional	YYYY-MM-DD.
assignee_email	string	Optional	An active person in your workspace.

Limit: 20 per minute, 200 per hour

update_taskEveryoneChanges a task

Changes only the fields you send: title, status, priority, due date, percent done or assignee. It cannot delete anything.

Parameter	Type	Needed	Notes
task_id	string	Required	A task id from list_tasks.
title, status, priority, due_date, percent, assignee_email	mixed	Optional	Send the ones to change. An empty due_date clears it.

Limit: 30 per minute, 300 per hour

add_task_commentEveryoneWrites a comment

Adds a comment to a task as the person who connected the app.

Parameter	Type	Needed	Notes
task_id	string	Required	A task id from list_tasks.
body	string	Required	The comment, up to 8000 characters.

Limit: 20 per minute, 300 per hour

Safe by design

You stay in control

Your permissions

The app acts as the person who connected it. It sees only rooms and messages that person can see, and the read commands are limited to Workspace admins and Paying.co staff. Client contacts can post but not read back.

Clients protected

In a room with clients, every post must be marked shared or team only. The app is instructed to ask you when you have not said, so nothing reaches a client by accident.

Metadata for files

Files are listed by name, type, size and uploader. Their contents are never sent to the AI app.

Limits and audit

Every command has per-minute and per-hour limits, and each call is recorded in an audit log.

Try asking

Example prompts

List my roomwork rooms and tell me which ones have clients in them.

Summarize what happened in the Acme certification room this week.

Read the long email Dana forwarded yesterday in the Acme room and pull out the open questions.

Which files were uploaded to the SoftPOS room in the last few days?

Post a team-only note in the Acme room that the test lab confirmed Thursday.

What tasks are still open on the Acme certification project, and which are overdue?

Create a task in the SoftPOS project to book the test lab for next week and assign it to me.

Roomwork is developed by Paying.co. Learn why we built it as one platform.

Questions

MCP server FAQ

What is the roomwork MCP server?

It is a remote Model Context Protocol server at https://roomwork.co/mcp. It lets an MCP app such as Claude list the rooms you can use, read recent messages and file names, and post messages, all as you and within your permissions.

Which commands does it support?

Twelve: list_rooms, send_message, list_messages, read_message, list_files, list_projects, list_clients, list_tasks, get_task, create_task, update_task and add_task_comment. The read commands are offered to Workspace admins and Paying.co staff only. Projects, clients and tasks are limited to the projects of the rooms you ticked, and nothing can be deleted.

How do I sign in?

Roomwork uses OAuth 2.0 with PKCE. Add the server address in your AI app, then approve the connection on the roomwork sign-in page that opens. You never paste a password or a key into the AI app.

Who do messages appear from?

Messages posted through MCP appear under the name of the person who connected the app, in the room you choose.

Can an AI app message my clients by accident?

No. When a room includes clients, send_message requires an audience of shared (clients can see it) or team (team only), and the app is told to ask you if you have not said.

Can it read file contents?

No. list_files returns names, types, sizes, who uploaded each file, when, any note and a link to open it in roomwork. File contents are not sent to the AI app.

Are there limits?

Yes. Each command has a per-minute and per-hour limit per connection, listed on this page, and every call is recorded in an audit log.

How do I disconnect?

Remove the connector in your AI app. The connection can also be revoked from roomwork, and the revoke endpoint is part of the standard OAuth discovery.

Connect Claude to
your rooms.

Set it up in a minute

Twelve commands, one for each job

You stay in control

Example prompts

MCP server FAQ

Bring your AI app into the room.