HQBase

Connect AI agents to your self-hosted HQBase shared email workspace.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "hqbase": {
      "command": "npx",
      "args": [
        "-y",
        "hqbase"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

HQBase

Your team's email workspace. On your infrastructure.

An open-source shared email workspace that runs in your Cloudflare account and keeps mail and credentials in infrastructure you control.

Website · Documentation · Releases · Contributing

About HQBase

HQBase shared inbox interface

HQBase gives teams one place to work with shared mailboxes while keeping the application, mail, and Cloudflare credentials in customer infrastructure. It includes:

Shared mailboxes and team access controls.
Multi-domain setup, drafts, and audit history.
Installation, update, backup, and recovery operations.
An OAuth-protected remote MCP server.

See the product documentation for installation, daily use, architecture, and operations.

Made by the community

We love seeing people build around HQBase. Independent clients give you more ways to use your workspace:

Herald — A native macOS email client for HQBase.

HQBase has tested Herald for compatibility. It is made and maintained by independent community developers, so its releases, support, and behavior remain in their care rather than HQBase's. Please review the project and decide whether it is right for your workspace.

Develop locally

Start the application

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

Before you run the optional seed command, add these values to .dev.vars:

BETTER_AUTH_SECRET
HQBASE_LOCAL_SEED_PASSWORD with 8 to 128 characters

The seed command writes only to local D1 and does not contact Cloudflare OAuth. Open http://127.0.0.1:5173/ and sign in as owner@hqbase.test with that password. Vite serves the frontend with live reload on port 5173 and proxies API requests to the Wrangler Worker on port 8787.

To use the first-run setup flow, omit the seed command and open http://localhost:5173/setup.

Reset local data

To discard all local D1 data, rebuild the schema, and recreate the demo workspace:

pnpm db:reset:local
pnpm db:seed:local

The reset command is destructive and local only. It does not change a deployed database.

Preview the setup interface

For presentation-only onboarding work:

pnpm dev:setup-ui

Open http://127.0.0.1:5173/__ui/setup.

Verify changes

Run the full local quality gate:

pnpm check
pnpm deploy:dry-run

Run pnpm cf:typegen after you change wrangler.jsonc.

Pushes to main run the same quality gate and deployment dry-run. Deployed staging is manual and also runs inside the signed release workflow. A release stays in draft until the previous stable version upgrades to the exact signed candidate and passes its checks. Customer installations and updates verify the signed manifest and artifact digest before deployment.

Documentation

hqbase.io/docs is the public source for user and operator guides, product specifications, and maintainer procedures.

Contributing

Read the contribution guide before you open a pull request.

Security

To report a vulnerability, follow the private process in the security policy.

License

HQBase is available under the GNU Affero General Public License v3.0 only.

Related MCP Servers

View all in Communication View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about HQBase

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "hqbase": { "command": "npx", "args": ["-y", "HQBase"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/hqbase?style=directory)](https://allmcps.com/mcp/hqbase)

HTML Embed

<a href="https://allmcps.com/mcp/hqbase"><img src="https://allmcps.com/api/badge/hqbase?style=directory" alt="HQBase on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to HQBase →Install in Claude Desktop Install in Cursor Install in VS Code

HQBase

Connect AI agents to your self-hosted HQBase shared email workspace.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "hqbase": {
      "command": "npx",
      "args": [
        "-y",
        "hqbase"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

HQBase

Your team's email workspace. On your infrastructure.

An open-source shared email workspace that runs in your Cloudflare account and keeps mail and credentials in infrastructure you control.

Website · Documentation · Releases · Contributing

About HQBase

HQBase shared inbox interface

HQBase gives teams one place to work with shared mailboxes while keeping the application, mail, and Cloudflare credentials in customer infrastructure. It includes:

Shared mailboxes and team access controls.
Multi-domain setup, drafts, and audit history.
Installation, update, backup, and recovery operations.
An OAuth-protected remote MCP server.

See the product documentation for installation, daily use, architecture, and operations.

Made by the community

We love seeing people build around HQBase. Independent clients give you more ways to use your workspace:

Herald — A native macOS email client for HQBase.

Develop locally

Start the application

pnpm install
pnpm db:migrate:local
pnpm db:seed:local
pnpm dev

Before you run the optional seed command, add these values to .dev.vars:

BETTER_AUTH_SECRET
HQBASE_LOCAL_SEED_PASSWORD with 8 to 128 characters

To use the first-run setup flow, omit the seed command and open http://localhost:5173/setup.

Reset local data

To discard all local D1 data, rebuild the schema, and recreate the demo workspace:

pnpm db:reset:local
pnpm db:seed:local

The reset command is destructive and local only. It does not change a deployed database.

Preview the setup interface

For presentation-only onboarding work:

pnpm dev:setup-ui

Open http://127.0.0.1:5173/__ui/setup.

Verify changes

Run the full local quality gate:

pnpm check
pnpm deploy:dry-run

Run pnpm cf:typegen after you change wrangler.jsonc.

Documentation

hqbase.io/docs is the public source for user and operator guides, product specifications, and maintainer procedures.

Contributing

Read the contribution guide before you open a pull request.

Security

To report a vulnerability, follow the private process in the security policy.

License

HQBase is available under the GNU Affero General Public License v3.0 only.

Related MCP Servers

View all in Communication View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about HQBase

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "hqbase": { "command": "npx", "args": ["-y", "HQBase"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/hqbase?style=directory)](https://allmcps.com/mcp/hqbase)

HTML Embed

<a href="https://allmcps.com/mcp/hqbase"><img src="https://allmcps.com/api/badge/hqbase?style=directory" alt="HQBase on AllMCPs" /></a>

Technical Specs & Signals

CategoryCommunication

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Featured

Moxie Docs MCP

MCP & Agent Skills for Automated Documentation, and codebase conventions + context

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💬 Communication →Best MCP servers for Slack & Communication →Alternatives to HQBase →Install in Claude Desktop Install in Cursor Install in VS Code