msteams-mcp 0.2.1

package/dist/tools/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tool handler registry.
+ *
+ * Provides a modular way to define MCP tool handlers without a monolithic
+ * switch statement. Each tool is defined with its schema, handler, and metadata.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { z } from 'zod';
+import type { McpError } from '../types/errors.js';
+import type { TeamsServer } from '../types/server.js';
+export type { TeamsServer };
+/** The context passed to tool handlers. */
+export interface ToolContext {
+    /** Reference to the server for browser operations. */
+    server: TeamsServer;
+}
+/** Result returned by tool handlers. */
+export type ToolResult = {
+    success: true;
+    data: Record<string, unknown>;
+} | {
+    success: false;
+    error: McpError;
+};
+import type { Result } from '../types/result.js';
+/**
+ * Helper to convert an API Result to a ToolResult.
+ *
+ * Reduces boilerplate in tool handlers by standardising the pattern:
+ * ```typescript
+ * if (!result.ok) {
+ *   return { success: false, error: result.error };
+ * }
+ * return { success: true, data: transform(result.value) };
+ * ```
+ *
+ * @param result - The API result to convert
+ * @param transform - Function to transform the success value to response data
+ * @returns A ToolResult suitable for returning from a handler
+ */
+export declare function handleApiResult<T>(result: Result<T>, transform: (value: T) => Record<string, unknown>): ToolResult;
+/** A registered tool with its handler. */
+export interface RegisteredTool<TInput extends z.ZodType = z.ZodType> {
+    /** Tool definition for MCP. */
+    definition: Tool;
+    /** Zod schema for input validation. */
+    schema: TInput;
+    /** Handler function. */
+    handler: (input: z.infer<TInput>, ctx: ToolContext) => Promise<ToolResult>;
+}
+export * from './search-tools.js';
+export * from './message-tools.js';
+export * from './people-tools.js';
+export * from './auth-tools.js';
+export * from './meeting-tools.js';
+export * from './registry.js';

package/dist/tools/index.js

@@ -0,0 +1,34 @@
+/**
+ * Tool handler registry.
+ *
+ * Provides a modular way to define MCP tool handlers without a monolithic
+ * switch statement. Each tool is defined with its schema, handler, and metadata.
+ */
+/**
+ * Helper to convert an API Result to a ToolResult.
+ *
+ * Reduces boilerplate in tool handlers by standardising the pattern:
+ * ```typescript
+ * if (!result.ok) {
+ *   return { success: false, error: result.error };
+ * }
+ * return { success: true, data: transform(result.value) };
+ * ```
+ *
+ * @param result - The API result to convert
+ * @param transform - Function to transform the success value to response data
+ * @returns A ToolResult suitable for returning from a handler
+ */
+export function handleApiResult(result, transform) {
+    if (!result.ok) {
+        return { success: false, error: result.error };
+    }
+    return { success: true, data: transform(result.value) };
+}
+// Re-export tool registrations
+export * from './search-tools.js';
+export * from './message-tools.js';
+export * from './people-tools.js';
+export * from './auth-tools.js';
+export * from './meeting-tools.js';
+export * from './registry.js';

package/dist/tools/meeting-tools.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Meeting/calendar-related tool handlers.
+ */
+import { z } from 'zod';
+import type { RegisteredTool } from './index.js';
+export declare const GetMeetingsInputSchema: z.ZodObject<{
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    limit?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}>;
+export declare const getMeetingsTool: RegisteredTool<typeof GetMeetingsInputSchema>;
+/** All meeting-related tools. */
+export declare const meetingTools: RegisteredTool<z.ZodObject<{
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    limit?: number | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}>>[];

package/dist/tools/meeting-tools.js

@@ -0,0 +1,64 @@
+/**
+ * Meeting/calendar-related tool handlers.
+ */
+import { z } from 'zod';
+import { handleApiResult } from './index.js';
+import { getCalendarView } from '../api/calendar-api.js';
+import { DEFAULT_MEETING_LIMIT, MAX_MEETING_LIMIT, } from '../constants.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// Schemas
+// ─────────────────────────────────────────────────────────────────────────────
+export const GetMeetingsInputSchema = z.object({
+    startDate: z.string().optional(),
+    endDate: z.string().optional(),
+    limit: z.number().min(1).max(MAX_MEETING_LIMIT).optional().default(DEFAULT_MEETING_LIMIT),
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Tool Definitions
+// ─────────────────────────────────────────────────────────────────────────────
+const getMeetingsToolDefinition = {
+    name: 'teams_get_meetings',
+    description: 'Get meetings from your Teams calendar. Returns meetings with: subject, startTime, endTime, organizer (name/email), location, joinUrl (Teams link), threadId (use with teams_get_thread to read meeting chat), myResponse (None/Accepted/Tentative/Declined), showAs (Free/Busy), isOrganizer. Defaults to next 7 days from now. For past meetings (e.g., "summarise my last meeting"), set startDate to a past date. To find meetings with a person, get results and filter by organizer.email.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            startDate: {
+                type: 'string',
+                description: 'Start of date range (ISO 8601, e.g., "2026-02-01T00:00:00.000Z"). Defaults to now.',
+            },
+            endDate: {
+                type: 'string',
+                description: 'End of date range (ISO 8601). Defaults to 7 days from now.',
+            },
+            limit: {
+                type: 'number',
+                description: 'Maximum number of meetings to return (default: 50, max: 200)',
+            },
+        },
+        required: [],
+    },
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Handlers
+// ─────────────────────────────────────────────────────────────────────────────
+async function handleGetMeetings(input, _ctx) {
+    const result = await getCalendarView({
+        startDate: input.startDate,
+        endDate: input.endDate,
+        limit: input.limit,
+    });
+    return handleApiResult(result, (value) => ({
+        count: value.count,
+        meetings: value.meetings,
+    }));
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export const getMeetingsTool = {
+    definition: getMeetingsToolDefinition,
+    schema: GetMeetingsInputSchema,
+    handler: handleGetMeetings,
+};
+/** All meeting-related tools. */
+export const meetingTools = [getMeetingsTool];

package/dist/tools/message-tools.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Messaging-related tool handlers.
+ */
+import { z } from 'zod';
+import type { RegisteredTool } from './index.js';
+export declare const SendMessageInputSchema: z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    replyToMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    replyToMessageId?: string | undefined;
+}, {
+    content: string;
+    conversationId?: string | undefined;
+    replyToMessageId?: string | undefined;
+}>;
+export declare const FavoriteInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+}, {
+    conversationId: string;
+}>;
+export declare const SaveMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    rootMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+    rootMessageId?: string | undefined;
+}, {
+    conversationId: string;
+    messageId: string;
+    rootMessageId?: string | undefined;
+}>;
+export declare const GetChatInputSchema: z.ZodObject<{
+    userId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+}, {
+    userId: string;
+}>;
+export declare const CreateGroupChatInputSchema: z.ZodObject<{
+    userIds: z.ZodArray<z.ZodString, "many">;
+    topic: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userIds: string[];
+    topic?: string | undefined;
+}, {
+    userIds: string[];
+    topic?: string | undefined;
+}>;
+export declare const EditMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const DeleteMessageInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const GetUnreadInputSchema: z.ZodObject<{
+    conversationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversationId?: string | undefined;
+}, {
+    conversationId?: string | undefined;
+}>;
+export declare const MarkAsReadInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>;
+export declare const GetActivityInputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+}, {
+    limit?: number | undefined;
+}>;
+export declare const SearchEmojiInputSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+export declare const AddReactionInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    emoji: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}>;
+export declare const RemoveReactionInputSchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    emoji: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}>;
+export declare const GetSavedMessagesInputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+}, {
+    limit?: number | undefined;
+}>;
+export declare const GetFollowedThreadsInputSchema: z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+}, {
+    limit?: number | undefined;
+}>;
+export declare const sendMessageTool: RegisteredTool<typeof SendMessageInputSchema>;
+export declare const getFavoritesTool: RegisteredTool<z.ZodObject<Record<string, never>>>;
+export declare const addFavoriteTool: RegisteredTool<typeof FavoriteInputSchema>;
+export declare const removeFavoriteTool: RegisteredTool<typeof FavoriteInputSchema>;
+export declare const saveMessageTool: RegisteredTool<typeof SaveMessageInputSchema>;
+export declare const unsaveMessageTool: RegisteredTool<typeof SaveMessageInputSchema>;
+export declare const getChatTool: RegisteredTool<typeof GetChatInputSchema>;
+export declare const createGroupChatTool: RegisteredTool<typeof CreateGroupChatInputSchema>;
+export declare const editMessageTool: RegisteredTool<typeof EditMessageInputSchema>;
+export declare const deleteMessageTool: RegisteredTool<typeof DeleteMessageInputSchema>;
+export declare const getUnreadTool: RegisteredTool<typeof GetUnreadInputSchema>;
+export declare const markAsReadTool: RegisteredTool<typeof MarkAsReadInputSchema>;
+export declare const getActivityTool: RegisteredTool<typeof GetActivityInputSchema>;
+export declare const searchEmojiTool: RegisteredTool<typeof SearchEmojiInputSchema>;
+export declare const addReactionTool: RegisteredTool<typeof AddReactionInputSchema>;
+export declare const removeReactionTool: RegisteredTool<typeof RemoveReactionInputSchema>;
+export declare const getSavedMessagesTool: RegisteredTool<typeof GetSavedMessagesInputSchema>;
+export declare const getFollowedThreadsTool: RegisteredTool<typeof GetFollowedThreadsInputSchema>;
+/** All message-related tools. */
+export declare const messageTools: (RegisteredTool<z.ZodObject<{
+    content: z.ZodString;
+    conversationId: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    replyToMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    replyToMessageId?: string | undefined;
+}, {
+    content: string;
+    conversationId?: string | undefined;
+    replyToMessageId?: string | undefined;
+}>> | RegisteredTool<z.ZodObject<Record<string, never>, z.UnknownKeysParam, z.ZodTypeAny, {
+    [x: string]: never;
+}, {
+    [x: string]: never;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+}, {
+    conversationId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    rootMessageId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+    rootMessageId?: string | undefined;
+}, {
+    conversationId: string;
+    messageId: string;
+    rootMessageId?: string | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    userId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+}, {
+    userId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    userIds: z.ZodArray<z.ZodString, "many">;
+    topic: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userIds: string[];
+    topic?: string | undefined;
+}, {
+    userIds: string[];
+    topic?: string | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}, {
+    content: string;
+    conversationId: string;
+    messageId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    messageId: string;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversationId?: string | undefined;
+}, {
+    conversationId?: string | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit?: number | undefined;
+}, {
+    limit?: number | undefined;
+}>> | RegisteredTool<z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>> | RegisteredTool<z.ZodObject<{
+    conversationId: z.ZodString;
+    messageId: z.ZodString;
+    emoji: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}, {
+    conversationId: string;
+    emoji: string;
+    messageId: string;
+}>>)[];