@projora/mcp-server 1.1.0 → 1.2.0

package/README.md

@@ -4,18 +4,27 @@ 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 (specify project key, title, and optional details)
 - **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
+- **update_task** - Update task fields (title, description, priority, assignee, due date)
+- **update_task_status** - Update task status
+
+### Task Lists
 - **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
+
+### Collaboration
 - **add_comment** - Add a comment to a task
 - **log_time** - Log time worked on a task
+- **link_branch** - Link a git branch or pull request to a task
+
+### Projects & Config
+- **list_projects** - List all projects
 - **get_project** - Get project details including linked GitHub repository
 - **get_config** - Get available statuses, priorities, and task types
 - **dashboard_stats** - Get dashboard statistics
@@ -82,6 +91,8 @@ Add to your OpenCode configuration (`opencode.json`):
 
 Once configured, use prompts like:
 
+- "Create a task in project PRJ: Fix the login button"
+- "Create a task in PRJ with title 'Add unit tests' and assign it to me"
 - "Start working on task PRJ-123"
 - "Show me my tasks"
 - "What are the overdue tasks?"
@@ -92,14 +103,18 @@ Once configured, use prompts like:
 
 ## Workflow Example
 
-1. **Start a task**: "Use projora to start working on task PRJ-123"
+1. **Create a task**: "Use projora to create a task in project PRJ: Implement user authentication"
+   - Task is created in the specified project
+   - Returns the task key (e.g., PRJ-123) for reference
+
+2. **Start the task**: "Use projora to start working on task PRJ-123"
    - Status automatically changes to "In Progress"
    - A comment is added noting work has started
    - You get the full task context including description, GitHub repo, and suggested branch name
 
-2. **Work on the task**: Make your changes, commit code, etc.
+3. **Work on the task**: Make your changes, commit code, etc.
 
-3. **Complete the task**: "Use projora to complete task PRJ-123 with summary: Implemented the new feature with tests"
+4. **Complete the task**: "Use projora to complete task PRJ-123 with summary: Implemented the new feature with tests"
    - Status changes to "Done"
    - A completion comment is added with your summary
 

package/build/index.js

@@ -1066,7 +1066,167 @@ server.registerTool("update_task", {
         content: [{ type: "text", text: `Updated ${result.updateTask.taskKey}: ${updatedFields}` }],
     };
 });
-// 14. Get project with GitHub info
+// 14. 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: {
+        projectKey: z.string().optional().describe("The project key (e.g., 'PRJ'). Either projectKey or taskListId is required."),
+        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."),
+        taskListId: z.string().optional().describe("The task list ID. If provided, projectKey and taskListName are ignored."),
+        title: z.string().describe("The task title (required)"),
+        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 ({ projectKey, taskListName, taskListId, title, description, statusId, priorityId, taskTypeId, assigneeId, dueDate, startDate, estimatedHours }) => {
+    let resolvedTaskListId = taskListId;
+    let projectName = "";
+    // If taskListId is not provided, we need to look it up from projectKey
+    if (!resolvedTaskListId) {
+        if (!projectKey) {
+            return {
+                content: [{ type: "text", text: "Either projectKey or taskListId is required to create a task." }],
+            };
+        }
+        // Get project and its task lists
+        const projectQuery = `
+        query GetProjectWithTaskLists {
+          projects {
+            id
+            name
+            key
+            taskLists {
+              id
+              name
+              sortOrder
+            }
+          }
+        }
+      `;
+        const projectData = await graphqlQuery(projectQuery);
+        if (!projectData) {
+            return {
+                content: [{ type: "text", text: "Failed to fetch projects. Check your authentication token." }],
+            };
+        }
+        const project = projectData.projects.find(p => p.key.toLowerCase() === projectKey.toLowerCase());
+        if (!project) {
+            const availableProjects = projectData.projects.map(p => p.key).join(", ");
+            return {
+                content: [{ type: "text", text: `Project '${projectKey}' not found. Available projects: ${availableProjects}` }],
+            };
+        }
+        projectName = project.name;
+        if (project.taskLists.length === 0) {
+            return {
+                content: [{ type: "text", text: `Project '${projectKey}' has no task lists. Please create a task list first.` }],
+            };
+        }
+        // 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}` }],
+                };
+            }
+            resolvedTaskListId = taskList.id;
+        }
+        else {
+            // Use the first task list (sorted by sortOrder)
+            const sortedLists = [...project.taskLists].sort((a, b) => a.sortOrder - b.sortOrder);
+            resolvedTaskListId = sortedLists[0].id;
+        }
+    }
+    // Build the input object
+    const input = {
+        taskListId: resolvedTaskListId,
+        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;
+    // Create the task
+    const mutation = `
+      mutation CreateTask($input: CreateTaskInput!) {
+        createTask(input: $input) {
+          id
+          taskKey
+          title
+          description
+          dueDate
+          startDate
+          estimatedHours
+          status { id name }
+          priority { id name }
+          taskType { id name }
+          assignee { id name }
+          project { id name key }
+          taskList { id name }
+          createdAt
+        }
+      }
+    `;
+    const result = await graphqlQuery(mutation, { input });
+    if (!result || !result.createTask) {
+        return {
+            content: [{ type: "text", text: "Failed to create task. Check your permissions and input values." }],
+        };
+    }
+    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 || 'Default'}\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.startDate) {
+        output += `- **Start Date**: ${task.startDate}\n`;
+    }
+    if (task.estimatedHours) {
+        output += `- **Estimate**: ${task.estimatedHours} hours\n`;
+    }
+    if (task.description) {
+        output += `\n## Description\n${task.description}\n`;
+    }
+    output += `\n---\n`;
+    output += `Created at: ${task.createdAt}\n`;
+    output += `\nYou can now use \`start_task\` with taskKey "${task.taskKey}" to begin working on it.`;
+    return {
+        content: [{ type: "text", text: output }],
+    };
+});
+// 15. Get project with GitHub info
 server.registerTool("get_project", {
     description: "Get project details including linked GitHub repository",
     inputSchema: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projora/mcp-server",
-  "version": "1.1.0",
+  "version": "1.2.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": {