Home

Hilla MCP Server

Use Hilla from ChatGPT, Claude, Cursor, or any MCP-compatible AI tool. Manage your project boards from wherever you work.

Quick Start

  1. 1Go to Settings → API Tokens in Hilla
  2. 2Generate an API token (starts with play_)
  3. 3Add the MCP server to your AI tool using the guides below

Setup Guides

ChatGPT

  1. 1. Go to Settings → Connectors
  2. 2. Create a custom MCP connector for Hilla
  3. 3. Set URL to:
    https://api.hilla.ai/functions/v1/mcp-server
  4. 4. Set authentication to Bearer Token and paste your play_ token

If your ChatGPT workspace asks for JSON, use:

{
  "name": "Hilla",
  "description": "Read and update Hilla project boards.",
  "server_url": "https://api.hilla.ai/functions/v1/mcp-server",
  "authentication": {
    "type": "bearer",
    "token": "play_YOUR_TOKEN_HERE"
  }
}

Claude (claude.ai web / mobile)

  1. 1. Open Settings → Connectors
  2. 2. Click Add custom connector
  3. 3. Name: Hilla
  4. 4. Remote MCP server URL:
    https://api.hilla.ai/functions/v1/mcp-server
  5. 5. Leave the OAuth Client ID and Secret fields empty.
  6. 6. Click Add. Claude will open a Hilla sign-in tab — approve, and the connector is live.

Try: "Use Hilla to list my projects" — Claude will call list_projects.

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hilla": {
      "type": "sse",
      "url": "https://api.hilla.ai/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer play_YOUR_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop after saving the config.

Cursor / Windsurf / Cline

Add to .cursor/mcp.json (or the equivalent config for your editor):

{
  "mcpServers": {
    "hilla": {
      "type": "sse",
      "url": "https://api.hilla.ai/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer play_YOUR_TOKEN_HERE"
      }
    }
  }
}

Cursor may require reloading the window before the Hilla tools appear.

Other MCP Clients

Any tool that supports the Model Context Protocol over SSE can connect. Use these settings:

URLhttps://api.hilla.ai/functions/v1/mcp-server
AuthBearer token (Authorization: Bearer play_...)
ProtocolMCP over SSE (JSON-RPC 2.0)
{
  "transport": "sse",
  "url": "https://api.hilla.ai/functions/v1/mcp-server",
  "headers": {
    "Authorization": "Bearer play_YOUR_TOKEN_HERE"
  }
}

Available Tools

ToolCredits
list_projects

List all your projects

Free
get_board

Get full board state for a project

Free
get_card

Get card details with tasks

Free
get_progress

Get progress summary

Free
create_project

Create a new project

1 credit
create_card

Add a card to the board

1 credit
add_tasks

Add tasks to a card

1 credit
complete_task

Mark a task as done

1 credit
update_card

Update card title, description, category, priority, or position

1 credit
set_card_priority

Set card priority

1 credit
delete_card

Remove a card from the board

1 credit
search

Search projects, cards, and tasks

Free

Authentication

All requests require a Bearer token via the Authorization header.

Tokens are prefixed with play_ and can be generated in Settings → API Tokens.

Only the SHA-256 hash of your token is stored. The raw token is shown once when generated — save it securely.

Rate Limits

60 / min

Read

list, get, progress

20 / min

Write

create, update, delete

10 / hr

Generate

AI plan generation

Example Prompts

"Show my Hilla projects"
"What's the progress on my SaaS Launch project?"
"Create a new card for user authentication under development"
"Add tasks for setting up CI/CD to the DevOps card"
"Mark the OAuth setup task as complete"
"Generate a plan for launching a newsletter"