Skip to content
LANCER

Documentation

MCP Server

Connect Cursor, Claude, ChatGPT, Kiro, or other MCP-compatible AI tools to your Lancer account to manage projects, tasks, and milestones.

Overview

The Lancer MCP server lets AI assistants create and update projects, tasks, subtasks (todos), and milestones in your Lancer account. Each connection uses a personal access token (PAT) scoped to one account — your AI tool never needs your login password.

  • Account-scoped tokens — one PAT works for a single Lancer account
  • 14 tools for projects, tasks, and milestones
  • Works with Cursor, Claude Desktop, ChatGPT Desktop, and Kiro
  • Built-in rate limits to protect your account and infrastructure

Step 1 — Create a personal access token

  1. Sign in to Lancer at https://app.lancer.pro
  2. Open Settings → Integrations → AI Tools
  3. Click "Create token", choose a name and expiration, then copy the token immediately
  4. Store the token securely — it is only shown once
Treat your PAT like a password. Revoke it immediately in Settings if it is exposed. You can have up to 5 active tokens per account.

Step 2 — Add the MCP config

All supported clients use the same mcpServers.lancer block. Replace lnc_pat_YOUR_TOKEN_HERE with the token you copied from Lancer.

{
  "mcpServers": {
    "lancer": {
      "command": "npx",
      "args": ["-y", "@lancerapp/mcp-server"],
      "env": {
        "LANCER_API_URL": "https://api.lancer.pro",
        "LANCER_PAT": "lnc_pat_YOUR_TOKEN_HERE"
      }
    }
  }
}

The account is inferred from your token automatically — you do not need to pass an account id in tool calls.

Cursor

ScopeConfig file
Global~/.cursor/mcp.json
Project.cursor/mcp.json
  1. Open Cursor → Settings → MCP (or edit the config file directly)
  2. Add the lancer entry under mcpServers (merge with existing servers if needed)
  3. Paste your PAT and confirm LANCER_API_URL is set correctly
  4. Restart Cursor or refresh the MCP panel

Claude Desktop

PlatformConfig file
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
  1. Quit Claude Desktop completely
  2. Open claude_desktop_config.json (create it if missing)
  3. Add the lancer entry under mcpServers and save
  4. Restart Claude Desktop

ChatGPT

ChatGPT Desktop (recommended for local MCP)

PlatformConfig file
macOS~/Library/Application Support/ChatGPT/mcp_config.json
Windows%APPDATA%\ChatGPT\mcp_config.json
  1. Edit mcp_config.json with the JSON block above
  2. In recent builds: Settings → Advanced → MCP Servers
  3. Restart ChatGPT Desktop
ChatGPT on the web (chatgpt.com) requires a remote HTTPS MCP endpoint. Use ChatGPT Desktop for the local npx-based Lancer MCP server.

Kiro

ScopeConfig file
Workspace.kiro/settings/mcp.json
User (global)~/.kiro/settings/mcp.json
  1. Open the command palette and run "Kiro: Open workspace MCP config (JSON)" (or user config)
  2. Add the lancer entry under mcpServers and save
  3. Confirm "lancer" appears in the MCP servers panel

Available tools

Projects

ToolDescription
list_projectsList all projects in the account
get_projectGet one project by id
create_projectCreate a new project
update_projectUpdate project fields

Tasks

ToolDescription
list_tasksList tasks with optional filters
get_taskGet one task including subtasks
create_taskCreate a task with optional subtasks (todos)
update_taskUpdate a task or replace subtasks
delete_taskDelete a task

Milestones

ToolDescription
list_milestonesList milestones in a project
get_milestoneGet one milestone
create_milestoneCreate a milestone (manager role required)
update_milestoneUpdate a milestone
delete_milestoneDelete a milestone
Todos are embedded subtasks on tasks — there is no separate todos API. Pass subtasks when creating or updating a task.

Rate limits & security

Lancer enforces limits on PAT-authenticated requests to prevent abuse and runaway AI tool usage.

LimitDefault
Requests per minute (per token)30
Requests per UTC day (per token)2,000
Active tokens (per account)5
  • HTTPS is required for non-local API URLs in the MCP client
  • Tokens are hashed at rest and shown only once at creation
  • Revoke tokens immediately if exposed
  • Never commit PATs to git or share config files containing real tokens

Troubleshooting

ErrorWhat to do
401 UnauthorizedToken is invalid or revoked — create a new PAT in Settings
403 ForbiddenInsufficient project role or missing scope
404 Not foundCheck project, task, or milestone ids
429 Too many requestsSlow down — wait for the minute or daily limit to reset
422 Validation errorCheck required fields (e.g. task name and status)

Need help? Contact support from the Lancer app or visit the Support page on this site.