Skip to content

README.md

Latest commit

 

History

History
104 lines (72 loc) · 2.73 KB

README.md

File metadata and controls

104 lines (72 loc) · 2.73 KB
Raw

@taskade/cli

Thin CLI for Taskade MCP plug-and-play. One command to connect Cursor or Claude to your Taskade workspace.

Quick Start

# 1. Get your token at https://taskade.com/settings/api (looks like tskdp_...)

# 2. Connect Cursor
npx @taskade/cli plug cursor

# 3. Connect Claude
npx @taskade/cli plug claude

# 4. Verify your token works
npx @taskade/cli whoami

What This Does

This CLI prints the MCP server config block you need to paste into your AI agent client (Cursor, Claude Desktop, Claude Code). It also verifies your Personal Access Token (PAT) works against the Taskade API.

The token is the product. You do not need this CLI to use Taskade MCP - you can copy the config block manually from https://taskade.com/settings/api. This CLI just makes it one command instead of five clicks.

Commands

taskade plug [cursor|claude]

Prints the MCP server config block.

npx @taskade/cli plug cursor   # Cursor format with instructions
npx @taskade/cli plug claude   # Claude Desktop/Code format with instructions
npx @taskade/cli plug          # Raw JSON, no client wrapper

Output (raw JSON):

{
  "mcpServers": {
    "taskade": {
      "url": "https://taskade.com/mcp",
      "headers": {
        "Authorization": "Bearer tskdp_..."
      }
    }
  }
}

taskade whoami

Verifies your PAT works against the Taskade API.

npx @taskade/cli whoami

Output:

Token works.
  User:  John Doe
  Email: john@example.com
  Plan:  pro

MCP server URL: https://taskade.com/mcp

Environment Variables

Variable Default Description
TASKADE_TOKEN (prompt) Your PAT (tskdp_...). Get one at https://taskade.com/settings/api
TASKADE_API_URL https://www.taskade.com API base URL (for self-hosted)

Requirements

  • Node.js 18+ (uses built-in fetch)

Hosted MCP vs stdio

Hosted MCP stdio (npm)
URL https://taskade.com/mcp npx @taskade/mcp-server
Auth PAT (tskdp_...) PAT (tskdp_...)
Tools 44 (Phase A complete) 14 (read-only subset)
Plan Starter+ Any
Best for Cursor, Claude Desktop, Claude Code Offline / air-gapped

Use hosted MCP. It has 3x more tools (including writes) and is maintained. The stdio wrapper is an offline fallback.

Related

License

MIT