How to Connect AI Agents to Hypertask with MCP

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants connect directly to external tools. With Hypertask's MCP server, your AI agent can create tasks, add comments, manage your inbox, search across projects, and much more — all without leaving your coding environment.

Supported AI Clients

Hypertask MCP works with:

• Claude Code (terminal)
• Claude Desktop (app)
• Cursor (IDE)
• VS Code (1.99+)
• ChatGPT (Business, Enterprise, or Edu plans)
• Lovable (paid plans)
• Any other MCP-compatible AI agent

Step 1: Generate Your API Token

1. Open Hypertask in your browser
2. Open the Hypertasks Command Center (HTC) by pressing Ctrl+K (Windows) or Cmd+K (Mac)
3. Type "MCP" and select the MCP Token option
4. Click Generate to create your token
5. Copy the token — it will only be shown once

Your token expires after 30 days. You can regenerate it anytime from the same menu. Generating a new token automatically revokes the previous one.

Step 2: Connect Your AI Client

Claude Code or Claude Desktop

Run this command in your terminal:

claude mcp add --transport http hypertask-mcp https://mcp.hypertask.ai/mcp

Then authenticate by typing /mcp in Claude and entering your token when prompted.

Cursor

Add this to your .cursor/mcp.json file (or configure via Cursor's MCP settings):

{
  "mcpServers": {
    "hypertask-mcp": {
      "url": "https://mcp.hypertask.ai/mcp"
    }
  }
}

Cursor will show a Connect button — click it and paste your token.

VS Code

Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and select MCP: Open User Configuration, or add to .vscode/mcp.json:

{
  "servers": {
    "hypertask-mcp": {
      "type": "http",
      "url": "https://mcp.hypertask.ai/mcp"
    }
  }
}

Requires VS Code 1.99 or later.

ChatGPT

1. Go to Settings → Apps & Connectors → Create
2. Enter the URL: https://mcp.hypertask.ai/mcp
3. Choose Bearer token authentication and paste your token

Requires a ChatGPT Business, Enterprise, or Edu plan with Developer mode enabled.

Lovable

1. Go to Settings → Connectors → Personal connectors → New MCP server
2. Enter the URL: https://mcp.hypertask.ai/mcp
3. Choose Bearer token authentication and paste your token

What Can Your AI Agent Do?

Once connected, your AI agent has access to 15 tools:

Task Management

• Create tasks — with title, description, priority, size estimates, and section placement
• Update tasks — change title, priority, labels, status, and more
• List and search tasks — filter by priority, assignee, due date, labels, or full-text search
• Move tasks — between sections or between different boards
• Assign users — assign or unassign team members

Collaboration

• Add comments — with @mentions that trigger notifications
• Read comments — view the full discussion thread on any task
• List project members — see who's on the team

Inbox & Notifications

• List inbox items — see assignments, mentions, and updates
• Archive inbox items — reach inbox zero

Projects & Boards

• List projects — see all your boards
• Manage sections — list, create, update, and delete columns
• Get user context — check your account info and accessible projects

Important Notes

• Task descriptions and comments use HTML formatting, not Markdown
• Your token expires after 30 days — regenerate it from Settings when needed
• Generating a new token revokes the previous one immediately
• You can revoke your token at any time by opening the HTC (Ctrl+K / Cmd+K) and searching for "MCP"

Example Use Cases

• Ask your AI to "create a task for the login bug on the Sprint board"
• Say "check my inbox and summarize what needs attention"
• Tell it to "move all done tasks to the Archive board"
• Ask "add a comment on task #42 saying the fix is deployed"

For the full technical reference of all available tools, see MCP Tools Reference.