MCP Task Simple Client

A Model Context Protocol (MCP) client bridge that enables Cursor/Claude to interact with your task management server for seamless task creation and management directly from your IDE.

Features

• 🚀 Quick Task Creation: Create tasks from current development context with AI assistance
• 📋 Task Management: Full CRUD operations for tasks (create, read, update, delete)
• 🔍 Smart Querying: Intelligent task filtering and contextual awareness
• 🎯 Cursor Integration: Seamless integration with Cursor IDE through MCP protocol
• 🌐 Remote Server Support: Connect to your task management server hosted anywhere

Available Tools

• cursor_quick_task - Create tasks quickly from current development context
• create_task - Create detailed tasks with specific parameters
• list_tasks - List and filter existing tasks
• get_task - Retrieve specific task details
• update_task - Update existing tasks
• start_task - Mark tasks as in progress
• complete_task - Mark tasks as completed
• cursor_task_query - Query tasks with natural language

Installation

Option 1: NPX (Recommended - No Installation Required)

Use directly with npx for zero-installation setup:

# No installation needed! Use directly in Cursor MCP config
npx mcp-task-simple-client

Option 2: NPM Global Installation

npm install -g mcp-task-simple-client

Configuration

Cursor Setup

1. Open Cursor Settings → Features → MCP
2. Click "Add New MCP Server"
3. Configure as follows:

NPX Usage (Recommended - Always Latest Version):

{
  "mcpServers": {
    "tasked-dot-work": {
      "command": "npx",
      "args": ["-y", "mcp-task-simple-client"],
      "env": {
        "MCP_SERVER_URL": "https://your-server-url.com",
        "DIRECTUS_TOKEN": "your-directus-token",
        "MCP_DEBUG": "true"
      }
    }
  }
}

Global Installation:

{
  "mcpServers": {
    "tasked-dot-work": {
      "command": "mcp-task-simple-client",
      "env": {
        "MCP_SERVER_URL": "https://your-server-url.com",
        "DIRECTUS_TOKEN": "your-directus-token",
        "MCP_DEBUG": "true"
      }
    }
  }
}

Environment Variables

• MCP_SERVER_URL - Your task management server URL
• DIRECTUS_TOKEN - Authentication token for your server
• MCP_DEBUG - Enable debug logging (optional)
• MCP_DEFAULT_USER_ID - Default user ID for task operations (optional)

Usage

Once configured, restart Cursor and the tools will be available in the Composer Agent. You can:

1. Create Quick Tasks: "Create a task for implementing user authentication"
2. List Tasks: "Show me all high priority tasks"
3. Update Tasks: "Mark task ABC123 as completed"
4. Query Tasks: "What tasks are related to the current file?"

Development

Local Development

# Clone the repository
git clone <repository-url>
cd simple-client

# Install dependencies
npm install

# Build the project
npm run build

# Test locally
node dist/index.js

Building

npm run build

Testing

Set environment variables and test:

export MCP_SERVER_URL="https://your-server-url.com"
export DIRECTUS_TOKEN="your-token"
export MCP_DEBUG="true"
node dist/index.js

Troubleshooting

Common Issues

1. "0 tools enabled"

   • Check environment variables are set correctly
   • Verify server URL is accessible
   • Check Directus token is valid

2. Connection Failed

   • Verify server URL (remove /mcp-rpc if present)
   • Check network connectivity
   • Validate authentication token

3. Tools Not Appearing

   • Restart Cursor after configuration changes
   • Check MCP server logs for errors
   • Verify MCP configuration syntax

Debug Mode

Enable debug mode by setting MCP_DEBUG=true to see detailed logs.

License

MIT

Support

For issues and questions, please check the troubleshooting section above or create an issue in the repository.