brioright-mcp 1.2.1 → 1.4.0

package/README.md

@@ -88,3 +88,9 @@ And pass the Authorization Header: `Bearer your_secure_bearer_token`.
 | `create_project` | Create a new project |
 | `list_members` | List workspace members (for finding assignee IDs) |
 | `get_workspace_summary` | Dashboard stats: task counts by status/priority |
+| `bulk_create_tasks` | Create multiple tasks at once |
+| `add_comment` | Add a comment to a task |
+| `get_task_comments` | Get all comments for a given task |
+| `log_time` | Log time entry for a project/task |
+| `add_task_attachment` | Upload a file attachment to a task using a Base64 encoded string |
+| `get_task_attachments` | List all file attachments for a specific task |

package/index.js

@@ -41,16 +41,21 @@ const MCP_SECRET = process.env.MCP_SECRET // Optional bearer token for HTTP mode
 const USE_HTTP = process.env.MCP_TRANSPORT === 'http'
 
 // ── Axios client factory ──────────────────────────────────────────────────────
-async function call(method, path, data, overrideApiKey) {
+async function call(method, path, data, overrideApiKey, customHeaders = {}) {
     const key = overrideApiKey || ENV_API_KEY;
     if (!key) {
         throw new Error('Brioright API error: No API Key provided. Either set BRIORIGHT_API_KEY environment variable or provide apiKey in the tool arguments.');
     }
 
+    const headers = { 'X-API-Key': key, 'Content-Type': 'application/json', ...customHeaders }
+    if (headers['Content-Type'] === 'multipart/form-data' || headers['Content-Type'] === null) {
+        delete headers['Content-Type']; // Let axios auto-generate the multipart boundary
+    }
+
     const api = axios.create({
         baseURL: API_URL,
-        headers: { 'X-API-Key': key, 'Content-Type': 'application/json' },
-        timeout: 10000,
+        headers,
+        timeout: 30000,
     })
 
     try {
@@ -129,6 +134,49 @@ function buildServer() {
         }
     )
 
+    // ── get_task_attachments ──────────────────────────────────────────────────
+    server.tool('get_task_attachments', 'List all file attachments for a specific task',
+        {
+            taskId: z.string(),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ taskId, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            const data = await call('GET', `/workspaces/${ws}/tasks/${taskId}/attachments`, null, apiKey)
+            const attachments = data.attachments || data
+            return { content: [{ type: 'text', text: JSON.stringify(attachments, null, 2) }] }
+        }
+    )
+
+    // ── add_task_attachment ───────────────────────────────────────────────────
+    server.tool('add_task_attachment', 'Upload a file attachment to a task using a Base64 encoded string',
+        {
+            taskId: z.string(),
+            fileName: z.string().describe('Name of the file to attach (e.g. image.png)'),
+            fileContent: z.string().describe('Base64 encoded string of the file content'),
+            mimeType: z.string().optional().describe('MIME type of the file (e.g. image/png)'),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ taskId, fileName, fileContent, mimeType, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            
+            // Convert base64 to Blob
+            const buffer = Buffer.from(fileContent, 'base64')
+            const blob = new Blob([buffer], { type: mimeType || 'application/octet-stream' })
+            
+            const formData = new FormData()
+            formData.append('file', blob, fileName)
+
+            const data = await call('POST', `/workspaces/${ws}/tasks/${taskId}/attachments`, formData, apiKey, { 'Content-Type': 'multipart/form-data' })
+            const attachment = data.attachment || data
+            return { content: [{ type: 'text', text: `✅ File attached successfully!\n\n${JSON.stringify({ id: attachment.id, name: attachment.name, url: attachment.url }, null, 2)}` }] }
+        }
+    )
+
     // ── create_task ───────────────────────────────────────────────────────────
     server.tool('create_task', 'Create a new task in a Brioright project',
         {
@@ -155,6 +203,41 @@ function buildServer() {
         }
     )
 
+    // ── bulk_create_tasks ─────────────────────────────────────────────────────
+    server.tool('bulk_create_tasks', 'Create multiple tasks at once in a Brioright project',
+        {
+            projectId: z.string().describe('Project ID'),
+            tasks: z.array(z.object({
+                title: z.string().describe('Task title'),
+                description: z.string().optional(),
+                status: z.enum(['todo', 'in_progress', 'in_review', 'done']).optional().default('todo'),
+                priority: z.enum(['low', 'medium', 'high', 'urgent']).optional().default('medium'),
+                dueDate: z.string().optional().describe('ISO date string e.g. 2026-03-15'),
+                assigneeId: z.string().optional(),
+                parentTaskId: z.string().optional(),
+                tags: z.array(z.string()).optional()
+            })).describe('Array of tasks to create'),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ projectId, tasks, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            
+            // Format dates
+            const formattedTasks = tasks.map(t => ({
+                ...t,
+                dueDate: t.dueDate ? new Date(t.dueDate).toISOString() : undefined
+            }))
+            
+            const data = await call('POST', `/workspaces/${ws}/projects/${projectId}/tasks/bulk`, {
+                tasks: formattedTasks
+            }, apiKey)
+            
+            return { content: [{ type: 'text', text: `✅ Successfully created ${data.count} tasks!` }] }
+        }
+    )
+
     // ── update_task ───────────────────────────────────────────────────────────
     server.tool('update_task', 'Update fields on an existing task',
         {
@@ -175,7 +258,7 @@ function buildServer() {
             if (updates.dueDate) updates.dueDate = new Date(updates.dueDate).toISOString()
             const data = await call('PATCH', `/workspaces/${ws}/tasks/${taskId}`, updates, apiKey)
             const task = data.task || data
-            return { content: [{ type: 'text', text: `✅ Task updated!\n\n${JSON.stringify({ id: task.id, title: task.title, status: task.status, priority: task.priority }, null, 2)}` }] }
+            return { content: [{ type: 'text', text: `✅ Task updated!\n\n${JSON.stringify({ id: task.id, title: task.title, status: task.status, priority: task.priority, description: task.description, dueDate: task.dueDate }, null, 2)}` }] }
         }
     )
 
@@ -231,6 +314,65 @@ function buildServer() {
         }
     )
 
+    // ── add_comment ───────────────────────────────────────────────────────────
+    server.tool('add_comment', 'Add a comment to a task',
+        {
+            taskId: z.string(),
+            text: z.string().describe('The content of the comment'),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ taskId, text, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            const data = await call('POST', `/workspaces/${ws}/tasks/${taskId}/comments`, { text }, apiKey)
+            const comment = data.comment || data
+            return { content: [{ type: 'text', text: `✅ Comment added!\n\n${JSON.stringify(comment, null, 2)}` }] }
+        }
+    )
+
+    // ── get_task_comments ─────────────────────────────────────────────────────
+    server.tool('get_task_comments', 'Get all comments for a given task',
+        {
+            taskId: z.string(),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ taskId, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            const data = await call('GET', `/workspaces/${ws}/tasks/${taskId}/comments`, null, apiKey)
+            const comments = data.comments || data
+            return { content: [{ type: 'text', text: JSON.stringify(comments.map(c => ({ id: c.id, text: c.text, author: c.author?.name, createdAt: c.createdAt })), null, 2) }] }
+        }
+    )
+
+    // ── log_time ──────────────────────────────────────────────────────────────
+    server.tool('log_time', 'Log time entry for a project/task',
+        {
+            projectId: z.string(),
+            taskId: z.string().optional(),
+            description: z.string().optional(),
+            startTime: z.string().optional().describe('ISO date string for start time. Defaults to now.'),
+            endTime: z.string().optional().describe('ISO date string for end time. If omitted, starts a running timer.'),
+            workspaceId: z.string().optional(),
+            apiKey: z.string().optional().describe('Brioright API Key')
+        },
+        async ({ projectId, taskId, description, startTime, endTime, workspaceId, apiKey }) => {
+            const ws = workspaceId || DEFAULT_WORKSPACE
+            if (!ws) throw new Error('workspaceId is required')
+            const start = startTime ? new Date(startTime).toISOString() : new Date().toISOString()
+            const end = endTime ? new Date(endTime).toISOString() : undefined
+            
+            const payload = { projectId, description, startTime: start, endTime: end }
+            if (taskId) payload.taskId = taskId
+            
+            const data = await call('POST', `/workspaces/${ws}/time-entries`, payload, apiKey)
+            const entry = data.entry || data
+            return { content: [{ type: 'text', text: `✅ Time logged (Duration: ${entry.duration ? entry.duration + ' seconds' : 'Running timer ...'})!\n\n${JSON.stringify({ id: entry.id, description: entry.description, startTime: entry.startTime, endTime: entry.endTime, duration: entry.duration }, null, 2)}` }] }
+        }
+    )
+
     return server
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "brioright-mcp",
-    "version": "1.2.1",
+    "version": "1.4.0",
     "description": "MCP server for Brioright — lets AI assistants create and manage tasks via natural language",
     "type": "module",
     "main": "index.js",

package/test-axios.mjs

@@ -1,20 +0,0 @@
-import axios from 'axios';
-
-async function test() {
-    const api = axios.create({
-        baseURL: 'https://brioright.online/api',
-        headers: { 'X-API-Key': 'brio_9847f9c385632d4d1c888afc42c8c3906ffad22bf7713c062a2d1c6db90adadf', 'Content-Type': 'application/json' },
-        timeout: 10000,
-    });
-
-    try {
-        const res = await api({ method: 'GET', url: '/workspaces', data: null });
-        console.log("SUCCESS:");
-        console.log(res.data);
-    } catch (err) {
-        console.log("ERROR:");
-        console.log(err.response?.data || err.message);
-    }
-}
-
-test();

package/test-axios2.mjs

@@ -1,20 +0,0 @@
-import axios from 'axios';
-
-async function test() {
-    const api = axios.create({
-        baseURL: 'https://brioright.online/api',
-        headers: { 'X-API-Key': 'brio_9847f9c385632d4d1c888afc42c8c3906ffad22bf7713c062a2d1c6db90adadf', 'Content-Type': 'application/json' },
-        timeout: 10000,
-    });
-
-    try {
-        const res = await api({ method: 'GET', url: '/workspaces' }); // data: undefined
-        console.log("SUCCESS:");
-        console.log(res.data);
-    } catch (err) {
-        console.log("ERROR:");
-        console.log(err.response?.data || err.message);
-    }
-}
-
-test();