Outlook Meetings Scheduler MCP Server

Instructions

Implementation Reference

• src/tools/people.ts:10-80 (registration)

  Registration of the 'find-person' tool using registerTool, including inline schema and handler.

    registerTool(
      server,
      "find-person",
      "Find a person's email address by their name",
      {
        name: z.string().describe("Name or partial name of the person to find"),
      },
      async ({ name }) => {
        const { graph, userEmail, authError } = await getGraphConfig();
  
        // Check for authentication errors
        if (authError) {
          return {
            content: [
              {
                type: "text",
                text: `🔐 Authentication Required\n\n${authError}\n\nPlease complete the authentication and try again.`,
              },
            ],
          };
        }
  
        // Search for the person by name
        const people = await graph.searchPeople(name, userEmail);
        
        if (!people) {
          return {
            content: [
              {
                type: "text",
                text: "Failed to search for people. Check the logs for details.",
              },
            ],
          };
        }
    
        if (people.length === 0) {
          return {
            content: [
              {
                type: "text",
                text: `No people found matching "${name}". Please provide the full email address.`,
              },
            ],
          };
        }
    
        // Format the results for response
        const peopleList = people.map((person: any, index: number) => {
          const email = person.mail || person.userPrincipalName || person.emailAddresses?.[0]?.address || "No email available";
          const displayName = person.displayName || "Unknown name";
          return `${index + 1}. ${displayName} (${email})`;
        }).join("\n");
        
        const successMessage = `
  Found ${people.length} people matching "${name}":
  
  ${peopleList}
  
  You can use these email addresses to create a calendar event.`;
    
        return {
          content: [
            {
              type: "text",
              text: successMessage,
            },
          ],
        };
      }
    );

• src/tools/people.ts:14-16 (schema)

  Input schema for the 'find-person' tool using Zod.

  {
    name: z.string().describe("Name or partial name of the person to find"),
  },

• src/tools/people.ts:17-79 (handler)

  Handler function for 'find-person' tool: authenticates, searches for people by name using graph API, formats results.

      async ({ name }) => {
        const { graph, userEmail, authError } = await getGraphConfig();
  
        // Check for authentication errors
        if (authError) {
          return {
            content: [
              {
                type: "text",
                text: `🔐 Authentication Required\n\n${authError}\n\nPlease complete the authentication and try again.`,
              },
            ],
          };
        }
  
        // Search for the person by name
        const people = await graph.searchPeople(name, userEmail);
        
        if (!people) {
          return {
            content: [
              {
                type: "text",
                text: "Failed to search for people. Check the logs for details.",
              },
            ],
          };
        }
    
        if (people.length === 0) {
          return {
            content: [
              {
                type: "text",
                text: `No people found matching "${name}". Please provide the full email address.`,
              },
            ],
          };
        }
    
        // Format the results for response
        const peopleList = people.map((person: any, index: number) => {
          const email = person.mail || person.userPrincipalName || person.emailAddresses?.[0]?.address || "No email available";
          const displayName = person.displayName || "Unknown name";
          return `${index + 1}. ${displayName} (${email})`;
        }).join("\n");
        
        const successMessage = `
  Found ${people.length} people matching "${name}":
  
  ${peopleList}
  
  You can use these email addresses to create a calendar event.`;
    
        return {
          content: [
            {
              type: "text",
              text: successMessage,
            },
          ],
        };
      }