@jorgeluismlima/teamwork-mcp 1.0.2 → 1.1.0

package/README.md

@@ -21,11 +21,21 @@ This server exposes the following tools:
 *   **`list_of_teamwork_project_categories`**: Helper tool to list categories.
 
 ### People & Companies
-*   **`get_project_people`**: Lists all people associated with a project.
+*   **`list_people`**: Lists all people across the site with comprehensive filtering (user type, search term, job role, etc.).
+*   **`get_project_people`**: Lists all people associated with a project, with 30+ optional filters.
 *   **`get_person`**: Retrieves detailed information about a specific person (user).
 *   **`list_companies`**: Lists companies (clients).
 *   **`get_company`**: Retrieves details of a specific company.
 
+### Projects & Updates
+*   **`get_project`**: Retrieves detailed information about a specific project, with comprehensive filtering and include options.
+*   **`get_all_project_updates`**: Lists updates across all projects.
+*   **`get_project_updates`**: Lists updates for a specific project.
+
+### Tags
+*   **`get_all_tags`**: Lists all tags with filtering by name, item type, etc.
+*   **`get_tag`**: Retrieves details of a specific tag.
+
 ## Configuration
 
 To use this server, you need to configure the following environment variables:

package/dist/index.js

@@ -315,11 +315,134 @@ server.tool("get_time_entries", {
         return handleApiError(error);
     }
 });
+server.tool("list_people", {
+    userType: z.enum(["account", "collaborator", "contact"]).optional().describe("user type"),
+    updatedAfter: z.string().optional().describe("date time"),
+    searchTerm: z.string().optional().describe("filter by comment content"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["name", "namecaseinsensitive", "company"]).optional().describe("order by"),
+    lastLoginAfter: z.string().optional().describe("last login after"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts"),
+    showDeleted: z.boolean().optional().describe("include deleted items"),
+    searchUserJobRole: z.boolean().optional().describe("Include user job role in search"),
+    orderPrioritiseCurrentUser: z.boolean().optional().describe("Force to have the current/session user in the response"),
+    onlySiteOwner: z.boolean().optional().describe("only site owner"),
+    onlyOwnerCompany: z.boolean().optional().describe("return people only from the owner company"),
+    inclusiveFilter: z.boolean().optional().describe("make the filter inclusive for user ids, teamIds, companyIds"),
+    includeServiceAccounts: z.boolean().optional().describe("include service accounts"),
+    includePlaceholders: z.boolean().optional().describe("include placeholder users"),
+    includeCollaborators: z.boolean().optional().describe("exclude collaborators types"),
+    includeClients: z.boolean().optional().describe("include clients"),
+    filterByNoCostRate: z.boolean().optional().describe("Returns users who are missing cost rates"),
+    excludeContacts: z.boolean().optional().describe("exclude contact types"),
+    adminsOnly: z.boolean().optional().describe("only include users with administrator status"),
+    teamIds: z.array(z.number()).optional().describe("team ids"),
+    projectIds: z.array(z.number()).optional().describe("filter by project ids"),
+    jobRoleIds: z.array(z.number()).optional().describe("filter by job role ids"),
+    include: z.array(z.string()).optional().describe("include related data"),
+    ids: z.array(z.number()).optional().describe("filter by user ids"),
+    excludeProjectIds: z.array(z.number()).optional().describe("exclude people assigned to certain project id"),
+    excludeIds: z.array(z.number()).optional().describe("exclude certain user ids"),
+    emails: z.array(z.string()).optional().describe("filter by user emails"),
+    companyIds: z.array(z.number()).optional().describe("company ids"),
+}, async (args) => {
+    try {
+        const params = { ...args };
+        // Helper to join arrays
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.teamIds)
+            params.teamIds = joinParam(args.teamIds);
+        if (args.projectIds)
+            params.projectIds = joinParam(args.projectIds);
+        if (args.jobRoleIds)
+            params.jobRoleIds = joinParam(args.jobRoleIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.ids)
+            params.ids = joinParam(args.ids);
+        if (args.excludeProjectIds)
+            params.excludeProjectIds = joinParam(args.excludeProjectIds);
+        if (args.excludeIds)
+            params.excludeIds = joinParam(args.excludeIds);
+        if (args.emails)
+            params.emails = joinParam(args.emails);
+        if (args.companyIds)
+            params.companyIds = joinParam(args.companyIds);
+        const response = await axiosInstance.get("/people.json", { params });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
 server.tool("get_project_people", {
     projectId: z.number().describe("The ID of the project"),
-}, async ({ projectId }) => {
+    userType: z.enum(["account", "collaborator", "contact"]).optional().describe("user type"),
+    updatedAfter: z.string().optional().describe("date time"),
+    searchTerm: z.string().optional().describe("filter by comment content"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["name", "namecaseinsensitive", "company"]).optional().describe("order by"),
+    lastLoginAfter: z.string().optional().describe("last login after"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts"),
+    showDeleted: z.boolean().optional().describe("include deleted items"),
+    searchUserJobRole: z.boolean().optional().describe("Include user job role in search"),
+    orderPrioritiseCurrentUser: z.boolean().optional().describe("Force to have the current/session user in the response"),
+    onlySiteOwner: z.boolean().optional().describe("only site owner"),
+    onlyOwnerCompany: z.boolean().optional().describe("return people only from the owner company"),
+    inclusiveFilter: z.boolean().optional().describe("make the filter inclusive"),
+    includeServiceAccounts: z.boolean().optional().describe("include service accounts"),
+    includePlaceholders: z.boolean().optional().describe("include placeholder users"),
+    includeObservers: z.boolean().optional().describe("include project observers"),
+    includeCollaborators: z.boolean().optional().describe("exclude collaborators types"),
+    includeClients: z.boolean().optional().describe("include clients"),
+    filterByNoCostRate: z.boolean().optional().describe("Returns users who are missing cost rates"),
+    excludeContacts: z.boolean().optional().describe("exclude contact types"),
+    adminsOnly: z.boolean().optional().describe("only include users with administrator status"),
+    teamIds: z.array(z.number()).optional().describe("team ids"),
+    projectIds: z.array(z.number()).optional().describe("filter by project ids"),
+    jobRoleIds: z.array(z.number()).optional().describe("filter by job role ids"),
+    include: z.array(z.string()).optional().describe("include related data"),
+    ids: z.array(z.number()).optional().describe("filter by user ids"),
+    excludeProjectIds: z.array(z.number()).optional().describe("exclude people assigned to certain project id"),
+    excludeIds: z.array(z.number()).optional().describe("exclude certain user ids"),
+    emails: z.array(z.string()).optional().describe("filter by user emails"),
+    companyIds: z.array(z.number()).optional().describe("company ids"),
+}, async (args) => {
     try {
-        const response = await axiosInstance.get(`/projects/${projectId}/people.json`);
+        const { projectId, ...restParams } = args;
+        const params = { ...restParams };
+        // Helper to join arrays
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.teamIds)
+            params.teamIds = joinParam(args.teamIds);
+        if (args.projectIds)
+            params.projectIds = joinParam(args.projectIds);
+        if (args.jobRoleIds)
+            params.jobRoleIds = joinParam(args.jobRoleIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.ids)
+            params.ids = joinParam(args.ids);
+        if (args.excludeProjectIds)
+            params.excludeProjectIds = joinParam(args.excludeProjectIds);
+        if (args.excludeIds)
+            params.excludeIds = joinParam(args.excludeIds);
+        if (args.emails)
+            params.emails = joinParam(args.emails);
+        if (args.companyIds)
+            params.companyIds = joinParam(args.companyIds);
+        const response = await axiosInstance.get(`/projects/${projectId}/people.json`, { params });
         return {
             content: [
                 {
@@ -603,6 +726,360 @@ server.tool("list_of_teamwork_project_categories", {}, async () => {
         return handleApiError(error);
     }
 });
+server.tool("get_project", {
+    projectId: z.number().describe("The ID of the project"),
+    updatedAfter: z.string().optional().describe("updated after"),
+    timeMode: z.enum(["timelogs", "estimated"]).optional().describe("profitability time mode"),
+    searchTerm: z.string().optional().describe("filter by project name"),
+    reportType: z.enum(["project", "health"]).optional().describe("define the type of the report"),
+    reportTimezone: z.string().optional().describe("Optional to configure the report dates displayed in a timezone"),
+    reportFormat: z.enum(["csv", "html", "pdf", "xls"]).optional().describe("define the format of the report"),
+    projectType: z.string().optional().describe("filter by project type"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["companyname", "datecreated", "duedate", "lastactivity", "name", "namecaseinsensitive", "ownercompany", "starred", "categoryname"]).optional().describe("order by"),
+    notCompletedBefore: z.string().optional().describe("filter by projects that have not been completed before the given date"),
+    minLastActivityDate: z.string().optional().describe("filter by min last activity date"),
+    maxLastActivityDate: z.string().optional().describe("filter by max last activity date"),
+    userId: z.number().optional().describe("filter by user id"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    orderByCustomFieldId: z.number().optional().describe("order by custom field id when orderBy is equal to customfield"),
+    minBudgetCapacityUsedPercent: z.number().optional().describe("filter by minimum budget capacity used"),
+    maxBudgetCapacityUsedPercent: z.number().optional().describe("filter by maximum budget capacity used"),
+    useFormulaFields: z.boolean().optional().describe("use formula fields"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts on a list API endpoint for performance reasons"),
+    searchCompanies: z.boolean().optional().describe("include companies in the search"),
+    searchByLetter: z.boolean().optional().describe("search projects beginning with the search term character only"),
+    onlyStarredProjects: z.boolean().optional().describe("filter by starred projects only"),
+    onlyProjectsWithExplicitMembership: z.boolean().optional().describe("only show projects with explicit membership"),
+    onlyProjectsThatCanLogTime: z.boolean().optional().describe("can log time on projects"),
+    onlyProjectsThatCanAddTasks: z.boolean().optional().describe("can add tasks on projects"),
+    onlyArchivedProjects: z.boolean().optional().describe("return only archived projects"),
+    matchAllProjectTags: z.boolean().optional().describe("match all project tags"),
+    matchAllExcludedTags: z.boolean().optional().describe("match all excluded project tags"),
+    isReportDownload: z.boolean().optional().describe("generate a report document"),
+    includeTentativeProjects: z.boolean().optional().describe("include alongside normal projects, tentative ones"),
+    includeTabSystemStatus: z.boolean().optional().describe("include tab system status in response"),
+    includeSubCategories: z.boolean().optional().describe("include sub categories when filtering by ids"),
+    includeStats: z.boolean().optional().describe("include project status counts"),
+    includeProjectUserInfo: z.boolean().optional().describe("fetch user-specific data such as isStarred"),
+    includeProjectProfitability: z.boolean().optional().describe("include project profitability in response"),
+    includeProjectDates: z.boolean().optional().describe("include minimum and maximum start/end dates for projects"),
+    includeCustomFields: z.boolean().optional().describe("include custom fields"),
+    includeCounts: z.boolean().optional().describe("include project related counts"),
+    includeCompletedStatus: z.boolean().optional().describe("include completed projects when filtering by project statuses current,late"),
+    includeArchivedProjects: z.boolean().optional().describe("include archived projects"),
+    hideObservedProjects: z.boolean().optional().describe("hide projects where the logged-in user is just an observer"),
+    alwaysIncludeFiltering: z.boolean().optional().describe("includes filters when project ids are provided"),
+    usersWithExplicitMembershipIds: z.array(z.number()).optional().describe("only show projects that have an explicit common membership with provided user ids"),
+    teamIds: z.array(z.number()).optional().describe("filter by projects that contain users associated with the team ids"),
+    selectedColumns: z.array(z.string()).optional().describe("select the columns to use in exports"),
+    projectTagIds: z.array(z.number()).optional().describe("filter by project tag ids"),
+    projectStatuses: z.array(z.string()).optional().describe("filter by project status (active, current, late, upcoming, completed, deleted)"),
+    projectOwnerIds: z.array(z.number()).optional().describe("filter by project owner ids"),
+    projectIds: z.array(z.number()).optional().describe("filter by project ids"),
+    projectHealths: z.array(z.number()).optional().describe("filter by project healths (0: not set, 1: bad, 2: ok, 3: good)"),
+    projectCompanyIds: z.array(z.number()).optional().describe("filter by company ids"),
+    projectCategoryIds: z.array(z.number()).optional().describe("filter by project category ids"),
+    includeCustomFieldIds: z.array(z.number()).optional().describe("include specific custom fields"),
+    include: z.array(z.string()).optional().describe("include related data"),
+    featuresEnabled: z.array(z.string()).optional().describe("filter by projects that have features enabled"),
+    excludeTagIds: z.array(z.number()).optional().describe("exclude by project tag ids"),
+    excludeProjectIds: z.array(z.number()).optional().describe("exclude certain project ids"),
+    // Field arrays for flattening
+    fieldsWorkflows: z.array(z.string()).optional().describe("fields[workflows]"),
+    fieldsUsers: z.array(z.string()).optional().describe("fields[users]"),
+    fieldsTags: z.array(z.string()).optional().describe("fields[tags]"),
+    fieldsStages: z.array(z.string()).optional().describe("fields[stages]"),
+    fieldsProjects: z.array(z.string()).optional().describe("fields[projects]"),
+    fieldsProjectCategories: z.array(z.string()).optional().describe("fields[projectcategories]"),
+    fieldsProjectUpdates: z.array(z.string()).optional().describe("fields[projectUpdates]"),
+    fieldsProjectBudgets: z.array(z.string()).optional().describe("fields[projectBudgets]"),
+    fieldsPortfolioColumns: z.array(z.string()).optional().describe("fields[portfolioColumns]"),
+    fieldsPortfolioCards: z.array(z.string()).optional().describe("fields[portfolioCards]"),
+    fieldsPortfolioBoards: z.array(z.string()).optional().describe("fields[portfolioBoards]"),
+    fieldsIndustries: z.array(z.string()).optional().describe("fields[industries]"),
+    fieldsCustomFields: z.array(z.string()).optional().describe("fields[customfields]"),
+    fieldsCustomFieldProjects: z.array(z.string()).optional().describe("fields[customfieldProjects]"),
+    fieldsCountries: z.array(z.string()).optional().describe("fields[countries]"),
+    fieldsCompanies: z.array(z.string()).optional().describe("fields[companies]"),
+}, async (args) => {
+    try {
+        const { projectId, ...restParams } = args;
+        const params = { ...restParams };
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.usersWithExplicitMembershipIds)
+            params.usersWithExplicitMembershipIds = joinParam(args.usersWithExplicitMembershipIds);
+        if (args.teamIds)
+            params.teamIds = joinParam(args.teamIds);
+        if (args.selectedColumns)
+            params.selectedColumns = joinParam(args.selectedColumns);
+        if (args.projectTagIds)
+            params.projectTagIds = joinParam(args.projectTagIds);
+        if (args.projectStatuses)
+            params.projectStatuses = joinParam(args.projectStatuses);
+        if (args.projectOwnerIds)
+            params.projectOwnerIds = joinParam(args.projectOwnerIds);
+        if (args.projectIds)
+            params.projectIds = joinParam(args.projectIds);
+        if (args.projectHealths)
+            params.projectHealths = joinParam(args.projectHealths);
+        if (args.projectCompanyIds)
+            params.projectCompanyIds = joinParam(args.projectCompanyIds);
+        if (args.projectCategoryIds)
+            params.projectCategoryIds = joinParam(args.projectCategoryIds);
+        if (args.includeCustomFieldIds)
+            params.includeCustomFieldIds = joinParam(args.includeCustomFieldIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.featuresEnabled)
+            params.featuresEnabled = joinParam(args.featuresEnabled);
+        if (args.excludeTagIds)
+            params.excludeTagIds = joinParam(args.excludeTagIds);
+        if (args.excludeProjectIds)
+            params.excludeProjectIds = joinParam(args.excludeProjectIds);
+        // Handle fields arrays
+        if (args.fieldsWorkflows)
+            params['fields[workflows]'] = joinParam(args.fieldsWorkflows);
+        if (args.fieldsUsers)
+            params['fields[users]'] = joinParam(args.fieldsUsers);
+        if (args.fieldsTags)
+            params['fields[tags]'] = joinParam(args.fieldsTags);
+        if (args.fieldsStages)
+            params['fields[stages]'] = joinParam(args.fieldsStages);
+        if (args.fieldsProjects)
+            params['fields[projects]'] = joinParam(args.fieldsProjects);
+        if (args.fieldsProjectCategories)
+            params['fields[projectcategories]'] = joinParam(args.fieldsProjectCategories);
+        if (args.fieldsProjectUpdates)
+            params['fields[projectUpdates]'] = joinParam(args.fieldsProjectUpdates);
+        if (args.fieldsProjectBudgets)
+            params['fields[projectBudgets]'] = joinParam(args.fieldsProjectBudgets);
+        if (args.fieldsPortfolioColumns)
+            params['fields[portfolioColumns]'] = joinParam(args.fieldsPortfolioColumns);
+        if (args.fieldsPortfolioCards)
+            params['fields[portfolioCards]'] = joinParam(args.fieldsPortfolioCards);
+        if (args.fieldsPortfolioBoards)
+            params['fields[portfolioBoards]'] = joinParam(args.fieldsPortfolioBoards);
+        if (args.fieldsIndustries)
+            params['fields[industries]'] = joinParam(args.fieldsIndustries);
+        if (args.fieldsCustomFields)
+            params['fields[customfields]'] = joinParam(args.fieldsCustomFields);
+        if (args.fieldsCustomFieldProjects)
+            params['fields[customfieldProjects]'] = joinParam(args.fieldsCustomFieldProjects);
+        if (args.fieldsCountries)
+            params['fields[countries]'] = joinParam(args.fieldsCountries);
+        if (args.fieldsCompanies)
+            params['fields[companies]'] = joinParam(args.fieldsCompanies);
+        const response = await axiosInstance.get(`/projects/${projectId}.json`, { params });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
+server.tool("get_all_project_updates", {
+    updatedAfter: z.string().optional().describe("filter by updated after"),
+    projectStatus: z.string().optional().describe("filter by project status"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["date", "color", "health", "project", "user"]).optional().describe("order by"),
+    createdAfter: z.string().optional().describe("filter by creation date"),
+    projectId: z.number().optional().describe("filter by project id"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts"),
+    showDeleted: z.boolean().optional().describe("include deleted items"),
+    reactions: z.boolean().optional().describe("add reactions to the response"),
+    onlyStarredProjects: z.boolean().optional().describe("filter by starred projects only"),
+    matchAllProjectTags: z.boolean().optional().describe("match all project tags"),
+    includeArchivedProjects: z.boolean().optional().describe("include archived projects"),
+    emoji: z.boolean().optional().describe("parse emojis to unicode"),
+    activeOnly: z.boolean().optional().describe("filter by active"),
+    projectTagIds: z.array(z.number()).optional().describe("filter by project tag ids"),
+    projectStatuses: z.array(z.string()).optional().describe("list of project status"),
+    projectOwnerIds: z.array(z.number()).optional().describe("filter by project owner ids"),
+    projectHealths: z.array(z.number()).optional().describe("filter by project health"),
+    projectCompanyIds: z.array(z.number()).optional().describe("filter by company ids"),
+    projectCategoryIds: z.array(z.number()).optional().describe("filter by project category ids"),
+    include: z.array(z.string()).optional().describe("include"),
+    fieldsUsers: z.array(z.string()).optional().describe("fields[users]"),
+    fieldsProjects: z.array(z.string()).optional().describe("fields[projects]"),
+    fieldsProjectUpdates: z.array(z.string()).optional().describe("fields[projectUpdates]"),
+}, async (args) => {
+    try {
+        const params = { ...args };
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.projectTagIds)
+            params.projectTagIds = joinParam(args.projectTagIds);
+        if (args.projectStatuses)
+            params.projectStatuses = joinParam(args.projectStatuses);
+        if (args.projectOwnerIds)
+            params.projectOwnerIds = joinParam(args.projectOwnerIds);
+        if (args.projectHealths)
+            params.projectHealths = joinParam(args.projectHealths);
+        if (args.projectCompanyIds)
+            params.projectCompanyIds = joinParam(args.projectCompanyIds);
+        if (args.projectCategoryIds)
+            params.projectCategoryIds = joinParam(args.projectCategoryIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.fieldsUsers)
+            params['fields[users]'] = joinParam(args.fieldsUsers);
+        if (args.fieldsProjects)
+            params['fields[projects]'] = joinParam(args.fieldsProjects);
+        if (args.fieldsProjectUpdates)
+            params['fields[projectUpdates]'] = joinParam(args.fieldsProjectUpdates);
+        const response = await axiosInstance.get("/projects/updates.json", { params });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
+server.tool("get_project_updates", {
+    projectId: z.number().describe("The ID of the project"),
+    updatedAfter: z.string().optional().describe("filter by updated after"),
+    projectStatus: z.string().optional().describe("filter by project status"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["date", "color", "health", "project", "user"]).optional().describe("order by"),
+    createdAfter: z.string().optional().describe("filter by creation date"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts"),
+    showDeleted: z.boolean().optional().describe("include deleted items"),
+    reactions: z.boolean().optional().describe("add reactions to the response"),
+    onlyStarredProjects: z.boolean().optional().describe("filter by starred projects only"),
+    matchAllProjectTags: z.boolean().optional().describe("match all project tags"),
+    includeArchivedProjects: z.boolean().optional().describe("include archived projects"),
+    emoji: z.boolean().optional().describe("parse emojis to unicode"),
+    activeOnly: z.boolean().optional().describe("filter by active"),
+    projectTagIds: z.array(z.number()).optional().describe("filter by project tag ids"),
+    projectStatuses: z.array(z.string()).optional().describe("list of project status"),
+    projectOwnerIds: z.array(z.number()).optional().describe("filter by project owner ids"),
+    projectHealths: z.array(z.number()).optional().describe("filter by project health"),
+    projectCompanyIds: z.array(z.number()).optional().describe("filter by company ids"),
+    projectCategoryIds: z.array(z.number()).optional().describe("filter by project category ids"),
+    include: z.array(z.string()).optional().describe("include"),
+    fieldsUsers: z.array(z.string()).optional().describe("fields[users]"),
+    fieldsProjects: z.array(z.string()).optional().describe("fields[projects]"),
+    fieldsProjectUpdates: z.array(z.string()).optional().describe("fields[projectUpdates]"),
+}, async (args) => {
+    try {
+        const { projectId, ...restParams } = args;
+        const params = { ...restParams };
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.projectTagIds)
+            params.projectTagIds = joinParam(args.projectTagIds);
+        if (args.projectStatuses)
+            params.projectStatuses = joinParam(args.projectStatuses);
+        if (args.projectOwnerIds)
+            params.projectOwnerIds = joinParam(args.projectOwnerIds);
+        if (args.projectHealths)
+            params.projectHealths = joinParam(args.projectHealths);
+        if (args.projectCompanyIds)
+            params.projectCompanyIds = joinParam(args.projectCompanyIds);
+        if (args.projectCategoryIds)
+            params.projectCategoryIds = joinParam(args.projectCategoryIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.fieldsUsers)
+            params['fields[users]'] = joinParam(args.fieldsUsers);
+        if (args.fieldsProjects)
+            params['fields[projects]'] = joinParam(args.fieldsProjects);
+        if (args.fieldsProjectUpdates)
+            params['fields[projectUpdates]'] = joinParam(args.fieldsProjectUpdates);
+        const response = await axiosInstance.get(`/projects/${projectId}/updates.json`, { params });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
+server.tool("get_all_tags", {
+    updatedAfter: z.string().optional().describe("search for tags updated after the provided date"),
+    searchTerm: z.string().optional().describe("filter by search term"),
+    orderMode: z.enum(["asc", "desc"]).optional().describe("order mode"),
+    orderBy: z.enum(["name", "count", "project", "color", "datelastupdated", "projectdatelastused"]).optional().describe("order by"),
+    itemType: z.enum(["all", "project", "task", "tasklist", "milestone", "message", "comment", "timelog", "file", "user", "company", "invoice", "risk", "notebook", "link", "event", "notebookversion", "fileversion"]).optional().describe("filter by item type"),
+    filter: z.enum(["all", "recent"]).optional().describe("mode used when filtering the tags"),
+    pageSize: z.number().optional().describe("number of items in a page"),
+    page: z.number().optional().describe("page number"),
+    withCounters: z.boolean().optional().describe("include in the response the number of items that use the tag"),
+    skipSpecial: z.boolean().optional().describe("do not include in the response special tags"),
+    skipCounts: z.boolean().optional().describe("SkipCounts allows you to skip doing counts"),
+    searchRightOnly: z.boolean().optional().describe("search term will be placed as a prefix to match the tag names"),
+    skipIds: z.array(z.number()).optional().describe("skip from the result tags with the defined ids"),
+    projectIds: z.array(z.number()).optional().describe("filter by projects"),
+    include: z.array(z.string()).optional().describe("include"),
+    ids: z.array(z.number()).optional().describe("filter by ids"),
+    fieldsTags: z.array(z.string()).optional().describe("fields[tags]"),
+}, async (args) => {
+    try {
+        const params = { ...args };
+        const joinParam = (arr) => arr ? arr.join(',') : undefined;
+        if (args.skipIds)
+            params.skipIds = joinParam(args.skipIds);
+        if (args.projectIds)
+            params.projectIds = joinParam(args.projectIds);
+        if (args.include)
+            params.include = joinParam(args.include);
+        if (args.ids)
+            params.ids = joinParam(args.ids);
+        if (args.fieldsTags)
+            params['fields[tags]'] = joinParam(args.fieldsTags);
+        const response = await axiosInstance.get("/tags.json", { params });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
+server.tool("get_tag", {
+    tagId: z.number().describe("The ID of the tag"),
+}, async ({ tagId }) => {
+    try {
+        const response = await axiosInstance.get(`/tags/${tagId}.json`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(response.data, null, 2),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return handleApiError(error);
+    }
+});
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -3,8 +3,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "1.0.2",
-  "description": "MCP Server for Teamwork",
+  "version": "1.1.0",
+  "description": "MCP Server for Teamwork API V3 - Projects, Time Entries, People, Companies, Tags, and Updates",
   "main": "dist/index.js",
   "bin": {
     "teamwork-mcp": "./dist/index.js"
@@ -16,7 +16,8 @@
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",