getFloorsClimbed
Retrieve daily, weekly, or monthly floors climbed data from your Fitbit account to track stair climbing activity 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:555-597 (handler)The handler function for the getFloorsClimbed tool. It constructs the appropriate Fitbit API endpoint based on date and period parameters, fetches the data using makeApiRequest helper, and returns formatted JSON response or error.async ({ date, period }) => { try { const formattedDate = formatDate(date); let endpoint = ""; if (period) { endpoint = `/user/-/activities/floors/date/${formattedDate}/${period}.json`; } else { endpoint = `/user/-/activities/floors/date/${formattedDate}/1d.json`; } const data = await makeApiRequest(endpoint); return { content: [ { type: "text", text: JSON.stringify( { date: formattedDate, floors: data["activities-floors"] || [], intraday: data["activities-floors-intraday"] || {}, }, null, 2 ), }, ], }; } catch (error) { return { content: [ { type: "text", text: `Error: ${ error instanceof Error ? error.message : String(error) }`, }, ], isError: true, }; } } );
- src/server.ts:545-554 (schema)Input schema defined using Zod for the getFloorsClimbed tool, specifying optional date and period 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:543-543 (registration)Registration of the getFloorsClimbed tool using server.tool, linking name, schema, and handler.server.tool(
- src/server.ts:68-73 (helper)Helper function to format date parameter for Fitbit API endpoints.function formatDate(date?: string): string { if (date) return date; const today = new Date(); return today.toISOString().split("T")[0]; // YYYY-MM-DD }
- src/server.ts:44-65 (helper)Helper function to make authenticated HTTP requests to the Fitbit API.async function makeApiRequest(endpoint: string): Promise<any> { try { const url = `${baseUrl}${endpoint}`; const response = await fetch(url, { headers: { Authorization: `Bearer ${accessToken}`, Accept: "application/json", }, }); if (!response.ok) { throw new Error( `Fitbit API error: ${response.status} ${response.statusText}` ); } return await response.json(); } catch (error) { console.error(`Error making request to ${endpoint}:`, error); throw error; } }