@taskly-run/mcp-client

MCP proxy client for Taskly.run - AI-Powered Documentation Platform. Connect your IDE (Amazon Q, Cursor, Claude Desktop) to your Taskly.run workspace.

Installation

npm install -g @taskly-run/mcp-client

Setup

1. Get Your API Key

1. Visit https://taskly.run/settings
2. Click "Generate New Key"
3. Copy your API key (shown only once!)

2. Configure Your IDE

Amazon Q

Edit %USERPROFILE%\.aws\amazonq\mcp.json (Windows) or ~/.aws/amazonq/mcp.json (Mac/Linux):

{
  "mcpServers": {
    "taskly": {
      "command": "taskly-mcp",
      "env": {
        "TASKLY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor

Edit %APPDATA%\Cursor\User\globalStorage\mcp.json (Windows) or ~/Library/Application Support/Cursor/User/globalStorage/mcp.json (Mac):

{
  "mcpServers": {
    "taskly": {
      "command": "taskly-mcp",
      "env": {
        "TASKLY_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

{
  "mcpServers": {
    "taskly": {
      "command": "taskly-mcp",
      "env": {
        "TASKLY_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Restart Your IDE

Completely restart your IDE to load the new MCP configuration.

Usage

Amazon Q

@taskly list my workspaces
@taskly search for "authentication"
@taskly create document "API Guide" in workspace 1, category 2
@taskly get document 5

Cursor

@taskly list workspaces
@taskly semantic search "React hooks"

Claude Desktop

Use the taskly tool to list workspaces
Use the taskly tool to search documents

Available Commands

• list_workspaces - List all your workspaces
• get_workspace - Get workspace details
• create_workspace - Create new workspace
• list_categories - List categories in workspace
• create_category - Create new category
• list_documents - List documents
• get_document - Get document content
• create_document - Create new document
• update_document - Update document
• search_documents - Keyword search
• semantic_search - AI-powered search
• hybrid_search - Combined search
• And 20+ more tools...

Troubleshooting

"TASKLY_API_KEY environment variable is required"

Make sure you've added your API key to the MCP config file.

"API error: 401 Unauthorized"

Your API key is invalid or expired. Generate a new one at https://taskly.run/settings

MCP not showing in IDE

1. Check config file exists and has correct JSON syntax
2. Verify taskly-mcp is installed: taskly-mcp --version
3. Restart IDE completely
4. Check IDE logs for errors

Connection timeout

Check your internet connection and verify https://taskly.run is accessible.

Support

• Documentation: https://docs.taskly.run
• Issues: https://github.com/taskly-run/mcp-client/issues
• Email: [email protected]