HQBase — Claude Code MCP server: what it does, how to install
Connects AI assistants to a self-hosted team email workspace on Cloudflare. Gives agents access to shared mailboxes, drafts, and audit logs.
Open on GitHubWhat HQBase 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.
What it helps with
- 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 for the agent
- 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
How to install HQBase
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http hqbase https://{installation_domain}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add hqbase --url https://{installation_domain}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"hqbase": {
"url": "https://{installation_domain}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"hqbase": {
"type": "http",
"url": "https://{installation_domain}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http hqbase https://{installation_domain}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about HQBase
How do I install HQBase in Claude Code?
Run claude mcp add --transport http hqbase https://{installation_domain}/mcp, replacing {installation_domain} with the host of your deployed HQBase instance.
What is HQBase?
It is an open-source shared email workspace that deploys to Cloudflare. It exposes an OAuth-protected remote MCP server for email operations.
What infrastructure does HQBase require?
The workspace runs on Cloudflare Workers and D1 database storage. All credentials and mailbox data remain within your own Cloudflare account.
