# HQBase

Connects AI assistants to a self-hosted team email workspace on Cloudflare. Gives agents access to shared mailboxes, drafts, and audit logs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 350
- Author: HQBase
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HQBase/hqbase
- Updated: 2026-10-12
- HTML: https://affpapa.org/en/nevibecode/mcp/hqbase

## What it does

HQBase runs a shared email workspace directly in your Cloudflare account. The remote MCP server operates over HTTP and relies on OAuth protection. Mail, domain configurations, and credentials stay inside your infrastructure.

The server lets coding agents interact with shared mailboxes, drafts, and audit records. Setup requires an existing deployment. Without an active instance serving `https://{installation_domain}/mcp`, the assistant cannot connect.

## Requirements
- Remote server: `https://{installation_domain}/mcp`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http hqbase https://{installation_domain}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add hqbase --url https://{installation_domain}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hqbase": {
            "url": "https://{installation_domain}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hqbase": {
            "type": "http",
            "url": "https://{installation_domain}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http hqbase https://{installation_domain}/mcp
```

## When to use it
- Inspect messages in shared team mailboxes
- Draft email replies from specific configured domains
- Review workspace audit history directly through an agent
- Keep email credentials inside personal Cloudflare infrastructure

## Example prompts
- Show recent unread messages from the support team mailbox
- Prepare a draft reply from our primary domain
- Review the workspace audit log for recent email actions

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

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