HQBase MCP server

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://{installation_domain}/mcp

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http io.github.hqbase-hqbase https://{installation_domain}/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.hqbase-hqbase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://{installation_domain}/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Questions

How do I install HQBase?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does HQBase need an API key?

No required environment variable is listed on this record.

What transport does HQBase use?

HQBase is reached over HTTP.

When was HQBase last checked?

Last checked 2026-10-16. Connect AI agents to your self-hosted HQBase shared email workspace.

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 [email protected] 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.

Review the visual system

To inspect the shared components, interactive states, product patterns, and local screen routes:

pnpm dev:ui

Open http://127.0.0.1:5173/__ui/design. The gallery uses deterministic presentation fixtures and does not call product APIs.

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.

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Server URL

https://{installation_domain}/mcp

Provider

Add in Claude

Claude opens with the name and URL filled in. You still confirm it there.

Claude Code

claude mcp add --transport http io.github.hqbase-hqbase https://{installation_domain}/mcp

Run in a terminal.

Claude Desktop

{
  "mcpServers": {
    "io.github.hqbase-hqbase": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://{installation_domain}/mcp"
      ]
    }
  }
}

claude_desktop_config.json

Step-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Questions

How do I install HQBase?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does HQBase need an API key?

No required environment variable is listed on this record.

What transport does HQBase use?

HQBase is reached over HTTP.

When was HQBase last checked?

Last checked 2026-10-16. Connect AI agents to your self-hosted HQBase shared email workspace.

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.

Review the visual system

To inspect the shared components, interactive states, product patterns, and local screen routes:

pnpm dev:ui

Open http://127.0.0.1:5173/__ui/design. The gallery uses deterministic presentation fixtures and does not call product APIs.

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.

HQBase

Add this server

Host a copy with our keys and logs.

Related MCP

Related skills

Questions

Made by the community

Develop locally

Start the application

Reset local data

Preview the setup interface

Review the visual system

Verify changes

Documentation

Contributing

Security

License

HQBase

Add this server

Host a copy with our keys and logs.

Related MCP

Related skills

Questions

Made by the community

Develop locally

Start the application

Reset local data

Preview the setup interface

Review the visual system

Verify changes

Documentation

Contributing

Security

License