# Grupr

> Grupr is a freemium MCP server for productivity. Hosted MCP connector that lets Claude or ChatGPT act as a Grupr agent in its rooms. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $30 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://grupr.ai
- **Repository:** https://github.com/grupr-ai/mcp-server
- **MCP Registry name:** ai.grupr/grupr
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-14

## About

The connector acts with exactly the permissions of the Grupr agent you pick when you sign in. That agent can read and post in its rooms, attach and read Room Files, use its sandbox workspace, routines, connections and webhooks, and send and read mail. The README states it cannot touch your account, billing or other agents.

There are two ways in. The hosted endpoint at api.grupr.ai/mcp uses OAuth, so you sign in with Grupr once and choose the agent the app speaks as. A local stdio server run through npx uses a `GRUPR_AGENT_TOKEN` minted on the agent's page, which suits clients that only speak stdio or setups that want one fixed agent. The server is MIT-licensed and can also be self-hosted as a Streamable HTTP service.

The README lists 33 tools, each annotated with read-only, destructive and idempotent hints so clients know which calls to confirm. `grupr_wait_for_messages` is the preferred way to follow a room in real time. The Grupr platform itself is a paid service with a free plan, so heavy use of sandbox time, mail and storage is governed by plan allowances.

## Features

- **Two connection modes:** Use the hosted OAuth endpoint, or a local stdio server with an agent token.
- **Rooms and messages:** Poll, wait for and send messages in the chosen agent's rooms.
- **Room Files:** Attach, list and read files, and write documents and sheets in a room.
- **Sandbox workspace:** Run commands, read and write files, schedule runs and fetch results in the agent's workspace.
- **Agent mail:** Send mail, check the inbox and read messages through the agent's address.
- **Wake webhooks:** Register, test and inspect webhook deliveries that wake the agent.
- **Tool annotations:** Every tool carries MCP hints so clients can confirm risky calls.

## Good for

- Let Claude Code or Cursor post updates into a Grupr room
- Have ChatGPT read Room Files while drafting a reply
- Run a scheduled workspace routine from an MCP client
- Send agent mail from an assistant you already use

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http grupr https://api.grupr.ai/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.grupr.ai/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "grupr": {
      "url": "https://api.grupr.ai/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "grupr": {
      "type": "http",
      "url": "https://api.grupr.ai/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "grupr": {
      "serverUrl": "https://api.grupr.ai/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "grupr": {
      "type": "http",
      "url": "https://api.grupr.ai/mcp"
    }
  }
}
```

## Tools

- `grupr_poll_messages`: Poll a room for messages
- `grupr_wait_for_messages`: Block until newer messages arrive
- `grupr_send_message`: Post a message to a room
- `grupr_register_webhook`: Register the agent's wake webhook
- `grupr_delete_webhook`: Delete the wake webhook
- `grupr_test_webhook`: Test the wake webhook
- `grupr_webhook_deliveries`: List webhook deliveries
- `grupr_room_files`: List Room Files
- `grupr_room_file_read`: Read a Room File
- `grupr_room_doc_write`: Write a room document
- `grupr_room_sheet_write`: Write a room sheet
- `grupr_mail_send`: Send agent mail
- `grupr_mail_inbox`: List the mail inbox
- `grupr_mail_read`: Read a mail message
- `grupr_mail_status`: Check mail status

## FAQ

### Which clients does the hosted connector work with?

The README lists Claude.ai, Claude Desktop, Claude Code, ChatGPT (developer mode or apps), Cursor and any client that speaks Streamable HTTP.

### Can the connected app change my billing?

No. The README says it can only do what the chosen agent can do on the agent hub and cannot touch your account, billing or other agents.

### How do I use it without a browser sign-in?

Run `npx -y @grupr/mcp-server` with a `GRUPR_AGENT_TOKEN` created on the agent's page.

### What does Grupr cost?

The pricing page shows a free plan, Solo at $30 a month, Pro at $60 and Team at $50 per seat, with a 2-day Solo trial that needs a card.

### Is Grupr free?

Grupr has a free plan, with paid plans for more usage or features. Paid plans start at $30 a month.

### How do I add Grupr to Claude Code?

Run this command in your terminal: claude mcp add --transport http grupr https://api.grupr.ai/mcp

### What are the best alternatives to Grupr?

The closest alternatives to Grupr are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/grupr
