MCP server

The MCP server module connects AI assistants, like Claude and ChatGPT, to GroupOffice with the Model Context Protocol. With it you can ask an assistant to, for example, find a contact, plan an appointment in your calendar, summarize the notes of a project or write a draft reply to an e-mail. It can do anything the user interface can possibly do if you allow the actions.

The module is part of the professional package.

Note

The MCP server module is in beta.

How it works

An AI assistant always acts as the user who connected it:

  • It can never see more than that user can. All permissions of GroupOffice still apply.

  • It can only use the items that the user selected when they connected it. For each item the user chooses if the assistant may only read it or may also change it.

  • It can’t send e-mail. It can save a draft that you check and send yourself in GroupOffice. Mail that GroupOffice normally sends when something is saved, like the comments of a support ticket, isn’t sent either.

  • It can make at most 120 requests per minute.

Install the module

  1. Install the “MCP server” module at System settings → Modules.

  2. Give the users or groups that may connect an AI assistant permission to use the module.

AI assistants on the internet, like claude.ai and ChatGPT, must be able to reach your GroupOffice. Make sure the URL in System settings → General is the public HTTPS address of your GroupOffice, because the server address of the MCP server is made with it.

Connect an AI assistant

Open My account and go to AI assistants.

The AI assistants page in My account

The AI assistants page in My account

  1. Copy the Server address with the copy button.

  2. Add this address as a custom connector in your AI assistant, like claude.ai, ChatGPT, Claude Desktop or Claude Code. For example, in Claude Code you run:

    claude mcp add --transport http groupoffice https://groupoffice.example.com/api/page.php/business/mcp/mcp
    
  3. The assistant opens GroupOffice in your browser. Log in if you aren’t already.

  4. Select the items the assistant may read. Select Change next to an item to also let the assistant create, change and delete it. Use Select all and Change all to select all items at once.

  5. Click Allow.

Allowing Claude Code to access GroupOffice

Allowing Claude Code to access GroupOffice

When the assistant runs on your own computer, like Claude Code or Claude Desktop, GroupOffice warns you about it. Only allow it if you started the assistant yourself.

The access of an assistant that you connected this way is valid for one year.

Manage connected assistants

Your connected assistants and MCP keys are listed on the AI assistants page with the number of items they may use, the date their access expires and the date they were last used.

  • To change the items of an assistant, double-click it, or click Edit in its more options menu (⋮).

  • To disconnect an assistant, click Delete in its more options menu (⋮). It can’t access GroupOffice anymore until you connect it again.

History

When the history module is installed, it also logs the changes that AI assistants make. Because an assistant acts as the user who connected it, that user is shown as the user who made the change. The Request ID column shows that an assistant made it: it starts with MCP: and the name of the assistant or MCP key, for example:

MCP: Claude Code JMAP Contact/set

MCP keys

Scripts and apps that can’t log in to GroupOffice use an MCP key instead. You can also use one for Claude Code on a computer without a browser.

  1. Click Create MCP key on the AI assistants page.

  2. Enter a Name, for example the name of the assistant or script.

  3. Choose when the key Expires at. By default this is 90 days from now.

  4. Select the items the key may read, and which it may change.

  5. Click Save.

Creating an MCP key

Creating an MCP key

GroupOffice then shows the key, the server address and the HTTP header to connect with, for example:

Authorization: Bearer <key>

It also shows the command to add the server to Claude Code with the key.

Warning

Copy the key right away. It’s not possible to view it again. Don’t paste the key into a chat with an AI assistant: anyone with the key can use your data.

Tools

The MCP server offers these tools to an AI assistant:

Tool

Description

whoami

The user the assistant acts as, the current date and time in the user’s time zone and the items it may use.

list_entities

The items the assistant may use, like contacts, calendar events or projects.

describe_entity

The properties and filters of an item.

jmap_read

Find and read items with the JMAP API.

jmap_write

Create, change and delete items with the JMAP API, if the assistant may change them.

create_blob

Upload a file, like a document the assistant wrote, to attach it to an item.

When you select one or more e-mail accounts, the assistant can also use these tools:

Tool

Description

email_mailboxes

The e-mail accounts it may use, with their folders and the number of unread messages.

email_query

Search the messages in a folder.

email_get

Read a message.

email_draft

Save a message as a draft in the Drafts folder. It’s not sent: you check and send it in GroupOffice.