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
- 1Go to Settings → API Tokens in Hilla
- 2Generate an API token (starts with
play_) - 3Add the MCP server to your AI tool using the guides below
Setup Guides
ChatGPT
- 1. Go to Settings → Connectors
- 2. Create a custom MCP connector for Hilla
- 3. Set URL to:
https://api.hilla.ai/functions/v1/mcp-server
- 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. Open Settings → Connectors
- 2. Click Add custom connector
- 3. Name:
Hilla - 4. Remote MCP server URL:
https://api.hilla.ai/functions/v1/mcp-server
- 5. Leave the OAuth Client ID and Secret fields empty.
- 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:
https://api.hilla.ai/functions/v1/mcp-serverAuthorization: Bearer play_...){
"transport": "sse",
"url": "https://api.hilla.ai/functions/v1/mcp-server",
"headers": {
"Authorization": "Bearer play_YOUR_TOKEN_HERE"
}
}Available Tools
| Tool | Credits |
|---|---|
list_projectsList all your projects | Free |
get_boardGet full board state for a project | Free |
get_cardGet card details with tasks | Free |
get_progressGet progress summary | Free |
create_projectCreate a new project | 1 credit |
create_cardAdd a card to the board | 1 credit |
add_tasksAdd tasks to a card | 1 credit |
complete_taskMark a task as done | 1 credit |
update_cardUpdate card title, description, category, priority, or position | 1 credit |
set_card_prioritySet card priority | 1 credit |
delete_cardRemove a card from the board | 1 credit |
searchSearch 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