getActiveZoneMinutes

Retrieve Fitbit Active Zone Minutes data for specified dates or periods to track moderate-to-vigorous exercise intensity and monitor fitness progress.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`date`	No	Date in YYYY-MM-DD format. If not specified, will use today.
`period`	No	Period for data: 1d, 7d, 30d, 1w, 1m

Implementation Reference

src/server.ts:726-767 (handler)

The handler function that fetches and returns active zone minutes data from the Fitbit API for the specified date and optional period, using shared helpers formatDate and makeApiRequest.

async ({ date, period }) => {
  try {
    const formattedDate = formatDate(date);
    let endpoint = "";

    if (period) {
      endpoint = `/user/-/activities/active-zone-minutes/date/${formattedDate}/${period}.json`;
    } else {
      endpoint = `/user/-/activities/active-zone-minutes/date/${formattedDate}/1d.json`;
    }

    const data = await makeApiRequest(endpoint);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            {
              date: formattedDate,
              activeZones: data["activities-active-zone-minutes"] || [],
              intraday: data["activities-active-zone-minutes-intraday"] || {},
            },
            null,
            2
          ),
        },
      ],
    };
  } catch (error) {
    return {
      content: [
        {
          type: "text",
          text: `Error: ${
            error instanceof Error ? error.message : String(error)
          }`,
        },
      ],
      isError: true,
    };
  }
}

src/server.ts:716-725 (schema)

Input schema using Zod for date (optional string) and period (optional string) parameters.

{
  date: z
    .string()
    .optional()
    .describe("Date in YYYY-MM-DD format. If not specified, will use today."),
  period: z
    .string()
    .optional()
    .describe("Period for data: 1d, 7d, 30d, 1w, 1m"),
},

src/server.ts:714-768 (registration)

The MCP server.tool registration for the getActiveZoneMinutes tool, including name, input schema, and handler function.

server.tool(
  "getActiveZoneMinutes",
  {
    date: z
      .string()
      .optional()
      .describe("Date in YYYY-MM-DD format. If not specified, will use today."),
    period: z
      .string()
      .optional()
      .describe("Period for data: 1d, 7d, 30d, 1w, 1m"),
  },
  async ({ date, period }) => {
    try {
      const formattedDate = formatDate(date);
      let endpoint = "";

      if (period) {
        endpoint = `/user/-/activities/active-zone-minutes/date/${formattedDate}/${period}.json`;
      } else {
        endpoint = `/user/-/activities/active-zone-minutes/date/${formattedDate}/1d.json`;
      }

      const data = await makeApiRequest(endpoint);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(
              {
                date: formattedDate,
                activeZones: data["activities-active-zone-minutes"] || [],
                intraday: data["activities-active-zone-minutes-intraday"] || {},
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error: ${
              error instanceof Error ? error.message : String(error)
            }`,
          },
        ],
        isError: true,
      };
    }
  }
);

FitBit MCP