# Hive MCP connector The Hive connector brings your Hive projects, teams, labels, workspaces and users to Claude, ChatGPT, Cursor and any MCP client through one endpoint, with each person working inside their own Hive access and every action recorded. Source: https://elaichi.ai/connectors/hive/ ## Facts | | | | --- | --- | | Application | Hive | | Category | Ticketing | | AI tools | 73 | | Authentication | Connects with an API key | | Needs your own OAuth app | No | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. 73 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` | ## What you can ask once Hive is connected - Which Hive projects changed in the last week? - List Hive workspace users in the Design group. - Create a Hive project for the Q3 migration. ## Connect Hive in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick Hive. 2. Optionally set Share with, then press Connect. 3. Paste a Hive API key. One person generates a token in Hive and pastes it once. Everyone else works through Share with, and never sees it. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Hive tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## Connect Hive to Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## Connect Hive to ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## Connect Hive to Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect Hive to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a Hive tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with Hive through Elaichi ### Set up a new project in a minute Operations. Ask for a new Hive project with the right name and owner, then have the people who will work on it added to the team. Everything is created in the workspace the person signed in to. ### Find out what projects are live Project management. Ask which Hive projects exist in a workspace, who leads each one, and which labels they carry, without opening every project card. ### Keep labels tidy across campaigns Marketing. Rename a stale Hive label, create a new one for the quarter's campaign, or retire one nobody uses, all from a plain-language request. ### Bring a new client's team together Client services. Create a Hive team for a new account, add the account manager and delivery people, and update the membership as the engagement grows. ### Onboard and offboard Hive users IT. Add a new hire as a Hive user, adjust their role tag when they change jobs, and remove the account when they leave, with each change logged to whoever asked for it. ### See how workspaces and groups are organized Leadership. Ask for a list of Hive workspaces, the groups inside them, and who belongs where, to check the structure matches how the organization actually works. ## Frequently asked questions ### How do I connect Hive to Claude? Connect Hive in Elaichi first, which asks you to paste an API key from your Hive account, and there is no OAuth application to register and no client ID or secret to generate. Then in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp as the endpoint. You sign in to Elaichi as yourself and Hive is ready to use in Claude. ### Does Hive work with ChatGPT and Cursor as well as Claude? Yes. Once Hive is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client, and the Elaichi Agent. You connect Hive once and every client you use picks it up. ### What can an AI agent actually do with my Hive data? With Hive connected, an agent can list and look up your Hive projects, teams, labels, workspaces, groups and users, and it can create, update or remove projects, teams, labels and users when you ask. Because Hive has a large set of actions, the agent searches for the right one as you ask, so short concrete requests such as "create a project called Q3 launch" work better than long paragraphs. ### Does connecting Hive give the AI access to every workspace and project? No. Every Hive action runs as the person who signed in, so the AI sees only the Hive workspaces, projects and users that person can already see in Hive. Elaichi can narrow that further with restrictions, but it can never grant more than Hive itself allows that person. ### Can my team share one Hive connection? Yes. One person connects Hive in Elaichi and shares the connection with a team, and nobody else ever handles the Hive API key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every change to a Hive project, team or user. ### Can I stop an agent from deleting or changing things in Hive? Yes. Restrictions in Elaichi apply per action, so you can allow reading Hive projects and labels while blocking the ability to delete a project, remove a user or change a team. A blocked action is never advertised to Claude, ChatGPT or any other client, so no prompt can reach it. ### What happens to a Hive connection when someone leaves? Offboarding a person in Elaichi ends their access to Hive through every client at once. If they connected Hive and shared it with a team, the shared connection keeps working for everyone else. Disconnecting Hive once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client at the same time. ## All 73 Hive tools Every tool below is callable through https://api.elaichi.ai/mcp once Hive is connected, subject to the toolbox it is in and the restrictions on the caller. - **List all Hive users** (List). Get a list of users filtered by email in Hive. Returns an array of user objects including id, fullName, email, and profile with firstName and lastName. - **Get single Hive user by ID** (Get). Get user by id in Hive. Returns id, profile with firstName and lastName, fullName, and email fields. - **Delete a Hive user by ID** (Delete). Remove a user from a workspace in Hive. Requires workspace_id and userId. Returns no content on success. - **Create a Hive user** (Create). Invite a new user to your workspace in Hive using workspace_id and email. Returns id and profile with firstName, lastName, fullName, and email of the invited user. - **Update a Hive user by ID** (Update). Update user profile by id in Hive. Returns id and updated profile fields: firstName, lastName, fullName, and email. - **List all Hive workspaces** (List). Get all workspaces that the user with user_id is a member of in Hive. Returns workspace id, name, members, createdAt, modifiedAt, createdBy, and modifiedBy fields. - **List all Hive groups** (List). Get all chat groups for a given workspace in Hive. Requires workspace_id. Returns groups with id, name, members, workspace, createdAt, createdBy, and modifiedBy fields. - **List all Hive workspace users** (List). Get all users for a given workspace in Hive. Requires workspace_id. Returns user id, profile with firstName and lastName, fullName, and email for each user. - **List all Hive user role tags** (List). Get user role tag for workspace with workspace_id and user with id in Hive. Returns _id, workspace, name, createdBy, modifiedBy, createdAt, and modifiedAt fields. - **Update a Hive user role tag by ID** (Update). Update user role tag with workspace_id, user_id, and id in Hive. Returns _id, workspace, name, createdBy, modifiedBy, createdAt, and modifiedAt fields in the response. - **List all Hive projects** (List). Get all projects for a given workspace in Hive. Requires workspace_id. Returns project id, name, description, startDate, endDate, accessOption, sharingType, members, template, createdAt, modifiedAt, createdBy, modifiedBy, projectCustomFields, color, parentProject, phases, budget, and resourcePlaceholderIds. - **Get single Hive project by ID** (Get). Get project by id in Hive. Returns project fields including id, name, description, startDate, endDate, accessOption, sharingType, members, template, createdAt, modifiedAt, createdBy, modifiedBy, projectCustomFields, color, parentProject, phases, budget, and resourcePlaceholderIds. - **Create a Hive project** (Create). Create a new project in Hive with required workspace and name. Returns project id, name, workspace, description, startDate, endDate, accessOption, sharingType, members, template, createdAt, modifiedAt, createdBy, modifiedBy, and projectCustomFields. - **Update a Hive project by ID** (Update). Update a project by id in Hive. Requires id. Returns updated project fields including id, name, description, startDate, endDate, accessOption, sharingType, members, template, createdAt, modifiedAt, createdBy, modifiedBy, and projectCustomFields. - **Delete a Hive project by ID** (Delete). Delete a project by id in Hive. Requires id of the project to delete. Returns status 200 on success. - **List all Hive teams** (List). Get all teams for your workspace in Hive. Requires workspace_id. Returns an array of teams with fields _id (team id), name (team name), workspace (workspace id), and members (array of member ids). - **Create a Hive team** (Create). Create a new team in Hive with required workspace, members, and name. Returns _id, name, members, workspace, deleted status, userId, createdBy, createdAt, modifiedAt, and isExternal fields in the response. - **Update a Hive team by ID** (Update). Update existing team with id in Hive by providing name and members. Returns updated team with fields _id, name, members, workspace, deleted, userId, createdBy, createdAt, modifiedAt, and isExternal. - **Delete a Hive team by ID** (Delete). Delete a team by id in Hive. Returns status 200 on success or 400 on error. - **List all Hive labels** (List). Get all labels for a workspace in Hive using workspace_id. Returns label fields _id, name, color, parent, createdBy, modifiedBy, createdAt, and modifiedAt. - **Get single Hive label by ID** (Get). Get label details by workspace_id and id in Hive. Returns _id, workspace, name, color, parent, createdBy, modifiedBy, createdAt, and modifiedAt fields. - **Update a Hive label by ID** (Update). Update an existing label in Hive with workspace_id and id. Returns _id, workspace, name, color, parent, createdBy, modifiedBy, createdAt, and modifiedAt fields in the response. - **Delete a Hive label by ID** (Delete). Delete an existing label by workspace_id and id in Hive. - **Create a Hive label** (Create). Create a new label in Hive with workspace_id, name, and color. Returns the created label with its _id, name, parent, and color fields. - **List all Hive actions** (List). Get all actions for a given workspace in Hive. Requires workspace_id. Returns action fields including status, parent, archived, milestone, and deleted. - **Get single Hive action by ID** (Get). Get information about a specific action in Hive using id. Returns fields including estimate which is the estimated time for the action in seconds or null if not present. - **Create a Hive action** (Create). Create a new action in Hive with workspace, title, and projectId. Returns id, title, workspace, assignees, projectId, customFields, createdAt, modifiedAt, createdBy, modifiedBy, status, deadline, scheduledDate, checkedDate, parent, root, hasSubactions, estimate, and loggedTime fields. - **Update a Hive action by ID** (Update). Update an action by id in Hive. Returns updated fields including id, title, workspace, assignees, projectId, customFields, status, deadline, scheduledDate, parent, archived, and other key action details. - **Delete a Hive action by ID** (Delete). Delete action by id in Hive. Returns a message confirming the deletion. - **List all Hive action comments** (List). Get comments for an action in Hive using id. Returns fields id, attachments, workspace, body, mentions, createdBy, createdAt, and reactions for each comment. - **Create a Hive action comment** (Create). Create an action comment for the action identified by id in Hive. Returns the comment id, body, workspace, createdAt timestamp, createdBy user, attachments, reactions, and mentions. - **List all Hive action attachments** (List). Get all attachments for an action in Hive by actionId. Returns _id, name, workspace, url, createdAt, createdBy, modifiedAt, and modifiedBy for each attachment. Excludes attachments from 3rd party file stores or nested in comments. - **Get single Hive action attachment by ID** (Get). Get attachment by attachmentId and actionId in Hive. Returns fields _id, name, workspace, url, createdAt, createdBy, modifiedAt, and modifiedBy of the file object. The file must exist on the corresponding action. - **Create a Hive action attachment** (Create). Create an action attachment for the action identified by id in Hive. Requires actionId and file URL. Returns a message confirming the attachment status. - **Hive action attachments download** (Download). Use this endpoint to download the actual file content of an attachment in Hive. The url for this request is obtained from the attachment metadata returned by the list or get attachment endpoints. - **List all Hive me** (List). Use this endpoint to retrieve the profile information of a specific user in Hive. - **List all Hive custom fields** (List). Get custom fields for a workspace in Hive. Requires workspace_id. Returns fields including _id (field identifier), label (field name), type (field type), workspace (workspace ID), deleted (deletion status), modifiedAt (last modification date), modifiedBy (modifier ID), and attachedToObject (associated object). - **Get single Hive custom field by ID** (Get). Get custom field by workspace_id and id in Hive. Returns _id, label, type, workspace, deleted, modifiedAt, modifiedBy, and attachedToObject fields. - **Create a Hive custom field** (Create). Create a custom field in Hive for workspace_id with label, type, and itemType. Returns _id, label, type, workspace, deleted, modifiedAt, modifiedBy, and attachedToObject fields in the response. - **List all Hive action templates** (List). Get all action templates for a given workspace in Hive. Requires workspace_id. Returns an array of action templates with fields id, name, createdAt, modifiedAt, createdBy, and modifiedBy. - **Hive action templates apply** (Action). Apply an action template to an existing action in Hive using action id and processId. Returns status 200 on success. - **List all Hive action history** (List). Get action history for a specific action in Hive. Requires id of the action. Returns the full history log including time, status, and user agent. - **List all Hive custom tags** (List). Get all custom tags of type user or project for workspace_id in Hive. Returns fields _id, workspace, name, type, options, isMulti, createdBy, modifiedBy, createdAt, and modifiedAt. - **Get single Hive custom tag by ID** (Get). Get a custom tag by id in Hive with workspace_id and id. Returns _id, name, type, isMulti, options, createdAt, createdBy, modifiedAt, and modifiedBy fields. - **Create a Hive custom tag** (Create). Create a new custom tag in Hive with workspace_id, name, and type. Returns _id, name, type, isMulti, options, createdAt, createdBy, modifiedAt, and modifiedBy fields. - **Update a Hive custom tag by ID** (Update). Update a custom tag by workspace_id and id in Hive. Returns _id, name, type, isMulti, options, createdAt, createdBy, modifiedAt, and modifiedBy fields. - **Delete a Hive custom tag by ID** (Delete). Delete a custom tag by workspace_id and id in Hive. Returns a message confirming deletion. - **Create a Hive message** (Create). Create a new message in Hive with workspace, body, senderName, senderPicture, and containerId. Returns id, sender, workspace, containerId, body, senderPicture, senderFirstName, createdBy, modifiedBy, createdAt, and modifiedAt. - **Create a Hive project custom field** (Create). Create a new custom field for a project in Hive using project_id. Returns the updated list of projectCustomFields including label, value, type, selectedValues, and hidden status. - **Update a Hive project custom field by ID** (Update). Update an existing custom field for a project in Hive using project_id and id. Returns the updated project object including id, name, description, startDate, endDate, accessOption, sharingType, members, createdAt, modifiedAt, createdBy, modifiedBy, and projectCustomFields with label, value, type, and other details. - **List all Hive project statuses** (List). Get project statuses for workspace_id in Hive. Returns edges array containing project status nodes with pagination info including totalCount, hasNextPage, and hasPreviousPage. - **Hive project statuses set** (Set). Set project status for a project in Hive using projectId and statusId. Returns _id, statusId, and description of the updated status. - **List all Hive project tags** (List). Get all project tags for workspace_id and project_id in Hive. Returns an array of tags with fields _id, projectId, name, options, selectedOptions, and isMulti indicating tag details and selection. - **Get single Hive project tag by ID** (Get). Get a single project tag for a given workspace_id, project_id, and id in Hive. Returns _id, name, options, selectedOptions, and isMulti fields of the project tag. - **Update a Hive project tag by ID** (Update). Update a project tag with id in Hive using workspace_id and project_id. Returns _id, name, options, selectedOptions, and isMulti fields reflecting the updated tag. - **List all Hive resource assignments** (List). Get resource assignments for workspace_id in Hive. Returns id, workspace, resourceId, projectId, startDate, endDate, allocationType, assignmentType, hoursPerDay, fixedHours, and fixedDisplayType fields. - **Get single Hive resource assignment by ID** (Get). Get resource assignment by id in Hive. Returns the resource assignment object matching the specified id. - **Create a Hive resource assignment** (Create). Create a new resource assignment in Hive with workspace, resourceId, startDate, endDate, and assignmentType. Returns the created resource assignment details. - **Update a Hive resource assignment by ID** (Update). Update resource assignment by id in Hive. Requires id and allows updating startDate, endDate, projectId, notes, assignmentType, allocationType, hoursPerDay, fixedHours, and fixedDisplayType. Returns updated resource assignment details. - **Delete a Hive resource assignment by ID** (Delete). Delete resource assignment by id in Hive. Returns status 200 on success. - **List all Hive role tags** (List). Get all role tags for a workspace in Hive. Requires workspace_id. Returns _id, workspace, name, createdBy, modifiedBy, createdAt, and modifiedAt for each role tag. - **Create a Hive role tag** (Create). Create a new role tag in Hive for workspace_id. Returns the created role tag with its name. - **Update a Hive role tag by ID** (Update). Update an existing role tag with id in workspace_id in Hive. Returns _id, workspace, name, createdBy, modifiedBy, createdAt, and modifiedAt fields. - **Delete a Hive role tag by ID** (Delete). Delete an existing role tag by workspace_id and id in Hive. - **Get single Hive status by ID** (Get). Get status by id in Hive. Returns the status details for the specified id. - **Create a Hive status** (Create). Create a status with name, color, and workspaceId in Hive. Returns _id, name, and color of the created status. - **Get single Hive user setting by ID** (Get). Get user setting by workspace_id and id in Hive. Returns workspaceId, _id, userId, firstDayOfWork, lastDayOfWork, billRate, and costRate fields. - **Update a Hive user setting by ID** (Update). Update user setting for workspace_id and id in Hive. Returns workspaceId, _id, userId, firstDayOfWork, lastDayOfWork, billRate, and costRate in the response. - **List all Hive user tags** (List). Get all user tags for a user in a workspace in Hive. Requires workspace_id and user_id. Returns an array of user tag objects including _id, userId, name, options, selectedOptions, and isMulti fields. - **Get single Hive user tag by ID** (Get). Get a single user tag for a given workspace and user in Hive. Requires workspace_id, user_id, and id. Returns _id, name, options, selectedOptions, and isMulti fields. - **Update a Hive user tag by ID** (Update). Update a specific user tag for user_id in workspace_id in Hive. Returns _id, name, options, selectedOptions, and isMulti fields representing the updated tag details. - **Create a Hive webhook** (Create). Create a webhook in Hive with required parameters name, workspaceId, trigger, and url. Returns webhook details including _id, name, workspaceId, trigger, url, projectIds, fields, filters, createdAt, and modifiedAt. - **Delete a Hive webhook by ID** (Delete). Delete webhook by id in Hive. Returns a message confirming the webhook deletion.