Integrations & API

Connect Hubstaff with your favorite tools and build custom workflows.

10 minutes

Hubstaff MCP Server

What is Hubstaff MCP?

The Hubstaff Model Context Protocol (MCP) server lets AI assistants and other MCP-compatible applications securely access and read data from your Hubstaff organization. Once connected, you can ask questions about your organization, team members, projects, tasks, time, and activity data, and receive responses based on your current Hubstaff information.

Hubstaff MCP is read-only. Connected applications can retrieve information from Hubstaff but cannot create, modify, or delete data in your Hubstaff account.

Who can use it?

Any organization member can use Hubstaff MCP after their organization or AI workspace administrator makes the Hubstaff connector or plugin available, when required. Each user authorizes the connection with their own Hubstaff account, and the data available through MCP depends on that account’s permissions.

What can Hubstaff MCP access?

After you authorize a connection, Hubstaff MCP can access the following information available to your Hubstaff account:

  • Organizations
  • Team members
  • Projects and tasks
  • Daily activity summaries
  • Detailed time and activity data

Hubstaff MCP is permission-aware and can access only the Hubstaff information available to the account used to authorize the connection.

Set up Hubstaff MCP for your organization

Organization owners and managers can sign in to Hubstaff and go to Settings > Integrations. Locate Hubstaff MCP, then click Set up to view the available setup instructions.

Hubstaff Integrations page showing the Hubstaff MCP Set up option

On the Hubstaff MCP setup page, select Claude, ChatGPT, or Other apps to view setup instructions for your preferred AI tool. Share the relevant instructions with members who need to connect through Claude Code, Codex CLI, or another MCP-compatible application.

Hubstaff MCP setup page showing Claude, ChatGPT, and Other apps

You can also open the Hubstaff MCP integration page directly.

Connect Hubstaff in your AI tool

After Hubstaff is available in the relevant AI workspace, individual members can authorize the connector or plugin with their own Hubstaff account. The information they can access depends on their Hubstaff permissions.

Connect Hubstaff to Claude

You can connect Hubstaff to Claude through the Claude web or desktop app, or through Claude Code. On the Hubstaff MCP setup page, select Claude to view instructions for both options.

Claude connector page showing how to connect Hubstaff

Claude web or app

  1. In Claude, open Customize > Connectors.
  2. Click +, then search for Hubstaff.
  3. Click Connect.
  4. Approve access if prompted.
If you use Claude Team or Enterprise, a Claude owner must first add Hubstaff in Organization settings > Connectors > Browse connectors, then click Add to your team. After that, each member can connect Hubstaff with the steps above. Until it is available, members see Request instead of Connect.

Claude Code

To connect Hubstaff to Claude Code, run the following command in your terminal:

claude mcp add --transport http hubstaff https://mcp.hubstaff.com/

Hubstaff MCP command for Claude Code

When prompted, complete the Hubstaff authorization in your browser.

Connect Hubstaff to ChatGPT and OpenAI tools

You can connect Hubstaff to ChatGPT by installing the Hubstaff plugin. You can also connect Hubstaff MCP to Codex CLI.

ChatGPT web or app

  1. In ChatGPT, open Plugins.
  2. Search for Hubstaff.
  3. Select the Hubstaff plugin, then click Install.
  4. Approve access if prompted.

Once connected, you can ask ChatGPT questions about the Hubstaff data available to your account.

ChatGPT plugin page showing how to install Hubstaff

If you use ChatGPT Enterprise or Edu, an administrator must first make Hubstaff available in the Admin console > Plugins. After that, each member can install the plugin and authorize it with their own Hubstaff account.

Codex CLI

To connect Hubstaff MCP to Codex CLI, run the following command in your terminal:

codex mcp add hubstaff --url https://mcp.hubstaff.com/

Hubstaff MCP command for Codex CLI

Your browser will open so you can sign in to Hubstaff and approve the connection.

Connect another MCP-compatible application

You can also connect Hubstaff to other applications that support the Model Context Protocol. On the Hubstaff MCP setup page, select Other apps to view general setup instructions.

Hubstaff MCP setup instructions for other MCP-compatible applications

Each application may use different terminology for its MCP settings. Look for options such as Connectors, MCP servers, Plugins, or Integrations.

  1. Find the option to add an MCP server or custom connector.
  2. Select a remote, URL, or streamable HTTP connection option instead of a local command.
  3. Paste the Hubstaff MCP address: https://mcp.hubstaff.com/
  4. Authorize Hubstaff access in your browser.
Hubstaff protects your credentials throughout the authorization process. You do not need to provide your Hubstaff password to the AI assistant.

Manage connected applications

Organization owners and managers can go to Settings > Integrations > Hubstaff MCP to view the Connected applications section, which shows the AI applications connected to their Hubstaff account, including when they were added and last connected.

MCP connections belong to your individual Hubstaff account, not to a specific organization. Access to Hubstaff data remains limited by your Hubstaff permissions.

Hubstaff MCP vs. the Hubstaff API

Hubstaff MCP is designed for AI assistants and MCP-compatible applications that need read-only access to Hubstaff information.

If you are building an integration, application, or automation, or need to create or modify Hubstaff data, use the Hubstaff API instead.

Need more information?

For additional technical information about Hubstaff MCP, visit the Hubstaff Developer Portal. If you need help connecting your account, contact Hubstaff Support.

Related articles

Back to top