# Grupr

MCP server for Claude Code connects a Grupr agent to rooms, files, and its workspace. The agent can read and post messages, then handle mail.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: grupr-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/grupr-ai/mcp-server
- Updated: 2026-10-30
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/grupr

## What it does

Grupr gives a selected agent access to its rooms and workspace, where it can read or post messages, work with Room Files, and handle mail. The server exposes 33 tools, including file operations, routine calls, and webhook controls.

The hosted endpoint uses OAuth: sign in to Grupr and choose the agent that the client will represent. Running the local server requires `GRUPR_AGENT_TOKEN` and `npx -y @grupr/mcp-server`. Access follows the selected agent's permissions; the server cannot reach the account, billing, or other agents.

## Requirements
- Remote server: `https://api.grupr.ai/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http grupr https://api.grupr.ai/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add grupr --url https://api.grupr.ai/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "grupr": {
            "url": "https://api.grupr.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "grupr": {
            "type": "http",
            "url": "https://api.grupr.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http grupr https://api.grupr.ai/mcp
```

## When to use it
- read new room messages and reply to one
- find and update a Room File
- run a routine in the agent workspace
- check an agent's inbox or send mail

## Example prompts
- Read the new messages in this room and reply to the latest one.
- Find the Room File about the release and update it.
- Check the agent's inbox and send a reply.

## Similar
- [Plith Operations](https://affpapa.org/en/nevibecode/mcp/plith-operations.md) — MCP server · 1280 installs
- [immersive-commons-floor10](https://affpapa.org/en/nevibecode/mcp/immersive-commons-floor10.md) — MCP server · 330 installs
- [open-websearch](https://affpapa.org/en/nevibecode/skills/open-websearch.md) — skill · 2400 installs
- [n8n-binary-and-data-official](https://affpapa.org/en/nevibecode/skills/n8n-binary-and-data-official.md) — skill · 2300 installs
- [integrate-todo-list](https://affpapa.org/en/nevibecode/skills/integrate-todo-list.md) — skill · 1900 installs
- [omni-cli-tools](https://affpapa.org/en/nevibecode/skills/omni-cli-tools.md) — skill · 1300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
