@projora/mcp-server 1.3.2 → 1.5.0

package/README.md

@@ -4,46 +4,66 @@ A Model Context Protocol (MCP) server for [Projora](https://projora.app) task ma
 
 ## Features
 
+### Task Management
+- **create_task** - Create a new task in a project with optional fields (priority, assignee, due date, etc.)
 - **start_task** - Start working on a task (sets status to "In Progress", adds comment, returns full context)
-- **complete_task** - Mark a task as done with an optional summary
-- **get_task** - Get a specific task by its key (e.g., "PRJ-123")
-- **list_projects** - List all projects
+- **complete_task** - Mark a task as done with optional summary and automatic time logging
+- **get_task** - Get detailed task information including comments, sub-tasks, and dependencies
+- **update_task** - Update task fields (title, description, priority, assignee, due date, estimate)
+- **update_task_status** - Update task status
+- **link_branch** - Link a git branch or pull request to a task
+
+### Time Tracking
+- **log_time** - Log time worked on a task with optional description
+- **add_comment** - Add a comment to a task
+
+### Queries & Search
+- **list_projects** - List all projects with task counts
 - **list_tasks** - List tasks with optional filters (project, status, priority, assignee)
 - **my_tasks** - Get tasks assigned to you
 - **overdue_tasks** - Get all overdue tasks
 - **search_tasks** - Search for tasks and projects by keyword
-- **update_task** - Update task fields (title, description, priority, assignee, due date)
-- **update_task_status** - Update task status
-- **add_comment** - Add a comment to a task
-- **log_time** - Log time worked on a task
+
+### Configuration & Stats
 - **get_project** - Get project details including linked GitHub repository
 - **get_config** - Get available statuses, priorities, and task types
-- **dashboard_stats** - Get dashboard statistics
+- **dashboard_stats** - Get dashboard statistics overview
 
 ## Installation
 
 ```bash
-npx @projora/mcp-server
+npm install -g @projora/mcp-server
 ```
 
-Or install globally:
+Or run directly with npx (no installation needed):
 
 ```bash
-npm install -g @projora/mcp-server
+npx projora-mcp-server setup
 ```
 
 ## Quick Setup
 
-Run this single command to automatically configure Claude Code or OpenCode:
+### For Claude Code (Recommended)
+
+Run this single command (replace `YOUR_TOKEN` with your API token):
+
+```bash
+claude mcp add projora \
+  --env PROJORA_AUTH_TOKEN="YOUR_TOKEN" \
+  -- npx -y projora-mcp-server
+```
+
+Get your API token from [Projora Settings](https://projora.app/settings/integrations).
+
+### For OpenCode
+
+Run the setup wizard:
 
 ```bash
-npx @projora/mcp-server setup
+npx projora-mcp-server setup
 ```
 
-The setup wizard will:
-1. Prompt for your API token (get it from [Projora Settings](https://projora.app/settings/integrations))
-2. Automatically configure your AI coding assistant
-3. No manual editing of config files required!
+The wizard will prompt for your API token and automatically configure OpenCode.
 
 ### Manual Configuration
 
@@ -97,6 +117,7 @@ Add to your `opencode.json`:
 
 Once configured, use prompts like:
 
+- "Create a task in project PROJ: Fix authentication bug"
 - "Start working on task PRJ-123"
 - "Show me my tasks"
 - "What are the overdue tasks?"
@@ -104,6 +125,7 @@ Once configured, use prompts like:
 - "Mark task PRJ-123 as done with summary: Fixed the login bug"
 - "Add a comment to PRJ-123: Need to review the test coverage"
 - "Log 2 hours on task PRJ-123"
+- "Link branch feature/auth-fix to task PRJ-123"
 
 ## Workflow Example
 

package/build/index.js

@@ -1119,6 +1119,155 @@ server.registerTool("get_project", {
         content: [{ type: "text", text: output }],
     };
 });
+// 15. Create a new task
+server.registerTool("create_task", {
+    description: "Create a new task in a project. You can specify the project by key and optionally the task list name, or provide IDs directly. Returns the created task details.",
+    inputSchema: {
+        title: z.string().describe("The task title (required)"),
+        projectKey: z.string().optional().describe("The project key (e.g., 'PRJ'). Either projectKey or taskListId is required."),
+        taskListId: z.string().optional().describe("The task list ID. If provided, projectKey and taskListName are ignored."),
+        taskListName: z.string().optional().describe("Name of the task list to add the task to (e.g., 'To Do', 'Backlog'). If not provided, uses the first task list."),
+        description: z.string().optional().describe("Task description (supports markdown)"),
+        statusId: z.string().optional().describe("Status ID (use get_config to see available statuses)"),
+        priorityId: z.string().optional().describe("Priority ID (use get_config to see available priorities)"),
+        taskTypeId: z.string().optional().describe("Task type ID (use get_config to see available task types)"),
+        assigneeId: z.string().optional().describe("User ID to assign the task to"),
+        dueDate: z.string().optional().describe("Due date in YYYY-MM-DD format"),
+        startDate: z.string().optional().describe("Start date in YYYY-MM-DD format"),
+        estimatedHours: z.number().optional().describe("Estimated hours to complete the task"),
+    },
+}, async ({ title, projectKey, taskListId, taskListName, description, statusId, priorityId, taskTypeId, assigneeId, dueDate, startDate, estimatedHours }) => {
+    // If taskListId is not provided, we need to look it up from the project
+    let finalTaskListId = taskListId;
+    if (!finalTaskListId && projectKey) {
+        // Get the project's task lists
+        const projectQuery = `
+        query GetProject($projectKey: String!) {
+          projects {
+            id
+            key
+            name
+            taskLists {
+              id
+              name
+            }
+          }
+        }
+      `;
+        const projectData = await graphqlQuery(projectQuery);
+        if (!projectData) {
+            return {
+                content: [{ type: "text", text: "Failed to fetch project. Check your authentication token." }],
+            };
+        }
+        const project = projectData.projects.find(p => p.key.toLowerCase() === projectKey.toLowerCase());
+        if (!project) {
+            return {
+                content: [{ type: "text", text: `Project with key '${projectKey}' not found.` }],
+            };
+        }
+        if (project.taskLists.length === 0) {
+            return {
+                content: [{ type: "text", text: `Project '${projectKey}' has no task lists.` }],
+            };
+        }
+        // Find the task list by name, or use the first one
+        if (taskListName) {
+            const taskList = project.taskLists.find(tl => tl.name.toLowerCase() === taskListName.toLowerCase());
+            if (!taskList) {
+                const availableLists = project.taskLists.map(tl => tl.name).join(', ');
+                return {
+                    content: [{ type: "text", text: `Task list '${taskListName}' not found in project '${projectKey}'. Available lists: ${availableLists}` }],
+                };
+            }
+            finalTaskListId = taskList.id;
+        }
+        else {
+            finalTaskListId = project.taskLists[0].id;
+        }
+    }
+    if (!finalTaskListId) {
+        return {
+            content: [{ type: "text", text: "Either taskListId or projectKey must be provided." }],
+        };
+    }
+    // Create the task
+    const input = {
+        taskListId: finalTaskListId,
+        title,
+    };
+    if (description !== undefined)
+        input.description = description;
+    if (statusId !== undefined)
+        input.statusId = statusId;
+    if (priorityId !== undefined)
+        input.priorityId = priorityId;
+    if (taskTypeId !== undefined)
+        input.taskTypeId = taskTypeId;
+    if (assigneeId !== undefined)
+        input.assigneeId = assigneeId;
+    if (dueDate !== undefined)
+        input.dueDate = dueDate;
+    if (startDate !== undefined)
+        input.startDate = startDate;
+    if (estimatedHours !== undefined)
+        input.estimatedHours = estimatedHours;
+    const mutation = `
+      mutation CreateTask($input: CreateTaskInput!) {
+        createTask(input: $input) {
+          id
+          taskKey
+          title
+          description
+          dueDate
+          startDate
+          estimatedHours
+          createdAt
+          status { id name }
+          priority { id name }
+          taskType { id name }
+          assignee { id name }
+          project { id name key }
+          taskList { id name }
+        }
+      }
+    `;
+    const result = await graphqlQuery(mutation, { input });
+    if (!result) {
+        return {
+            content: [{ type: "text", text: "Failed to create task. Check your permissions and input data." }],
+        };
+    }
+    const task = result.createTask;
+    let output = `# Task Created: ${task.taskKey}\n\n`;
+    output += `**${task.title}**\n\n`;
+    output += `- **Project**: ${task.project.name} (${task.project.key})\n`;
+    output += `- **List**: ${task.taskList.name}\n`;
+    output += `- **Status**: ${task.status?.name || 'No status'}\n`;
+    if (task.priority) {
+        output += `- **Priority**: ${task.priority.name}\n`;
+    }
+    if (task.taskType) {
+        output += `- **Type**: ${task.taskType.name}\n`;
+    }
+    if (task.assignee) {
+        output += `- **Assignee**: ${task.assignee.name}\n`;
+    }
+    if (task.dueDate) {
+        output += `- **Due Date**: ${task.dueDate}\n`;
+    }
+    if (task.estimatedHours) {
+        output += `- **Estimate**: ${task.estimatedHours} hours\n`;
+    }
+    if (task.description) {
+        output += `\n## Description\n${task.description}\n`;
+    }
+    output += `\n---\nCreated at: ${task.createdAt}\n\n`;
+    output += `You can now use \`start_task\` with taskKey "${task.taskKey}" to begin working on it.`;
+    return {
+        content: [{ type: "text", text: output }],
+    };
+});
 // Main function to run the server
 async function main() {
     // Check if "setup" command was passed

package/package.json

@@ -1,9 +1,11 @@
 {
   "name": "@projora/mcp-server",
-  "version": "1.3.2",
+  "version": "1.5.0",
   "description": "MCP server for Projora task management - integrate with Claude Code and OpenCode to manage tasks, update statuses, and track work",
   "type": "module",
-  "bin": "./build/index.js",
+  "bin": {
+    "projora-mcp-server": "./build/index.js"
+  },
   "main": "./build/index.js",
   "scripts": {
     "build": "tsc && chmod 755 build/index.js build/setup.js",