Skip to content
MCP server

Grupr

Hosted MCP connector that lets Claude or ChatGPT act as a Grupr agent in its rooms

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Remotely
Version
0.18.0
Listing updated
3 days ago

About Grupr

Grupr is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://api.grupr.ai/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "grupr": {
      "url": "https://api.grupr.ai/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $30 a month

Free plan; Solo $30/mo, Pro $60/mo, Team $50/seat/mo; connector is MIT-licensed

Prices change. Check grupr.ai before you buy.

Grupr 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 to Grupr

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media