outlook-reader-mcp 1.0.0 → 1.0.1

package/dist/auth.d.ts

@@ -0,0 +1,26 @@
+export declare function getConfig(): {
+    clientId: string;
+    tenantId: string;
+};
+/**
+ * Thrown when a request needs the user to sign in. Tool handlers surface the
+ * message as tool output so the model can tell the user exactly what to do —
+ * auth must never silently block inside a tool call.
+ */
+export declare class AuthRequiredError extends Error {
+}
+/**
+ * Kicks off the device code flow and resolves as soon as the verification
+ * URL + code are available, while MSAL keeps polling in the background.
+ * Calling again while a code is still valid returns the same code.
+ */
+export declare function startDeviceCodeAuth(): Promise<string>;
+/**
+ * Signs out: cancels any in-flight device code flow, drops the in-memory
+ * token, and removes all accounts from the persistent cache. Returns the
+ * usernames that were removed.
+ */
+export declare function clearAuth(): Promise<string[]>;
+/** Username of the signed-in account, or null when not authenticated. */
+export declare function getSignedInAccount(): Promise<string | null>;
+export declare function getAccessToken(): Promise<string>;

package/dist/files.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Attachment names come from the email sender, so they must be treated as
+ * untrusted input: strip any path components (prevents `..\` traversal),
+ * control characters, and characters Windows rejects in filenames.
+ */
+export declare function sanitizeFilename(name: string): string;
+/** Returns a path in `dir` that doesn't collide with an existing file. */
+export declare function uniquePath(dir: string, filename: string): string;

package/dist/mail.d.ts

@@ -0,0 +1,34 @@
+import { MailFolder, Message } from '@microsoft/microsoft-graph-types';
+export interface ListEmailsOptions {
+    top?: number;
+    skip?: number;
+    filter?: string;
+    folder?: string;
+    orderby?: string;
+}
+export declare function listEmails(options?: ListEmailsOptions): Promise<Message[]>;
+export declare function listFolders(): Promise<MailFolder[]>;
+export declare function getEmail(id: string): Promise<Message>;
+export type BatchEmailResult = {
+    ok: true;
+    message: Message;
+} | {
+    ok: false;
+    id: string;
+    error: string;
+};
+export declare function getEmails(ids: string[]): Promise<BatchEmailResult[]>;
+export declare function searchEmails(query: string, top?: number): Promise<Message[]>;
+export interface AttachmentInfo {
+    id: string;
+    name: string;
+    size: number;
+    contentType: string;
+    isInline: boolean;
+}
+export declare function listAttachments(messageId: string): Promise<AttachmentInfo[]>;
+export declare function downloadAttachment(messageId: string, attachmentId: string): Promise<{
+    name: string;
+    contentBytes: string;
+    contentType: string;
+}>;

package/dist/mcp-server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import 'dotenv/config';

package/dist/tools/authenticate/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Sign in to the Microsoft account used by the other tools. Returns a URL and a one-time code: show both to the user and tell them to complete the sign-in in their browser. Run this when other tools report that authentication is required. Safe to call anytime \u2014 reports the current account if already signed in.";
+export declare function handler(_input: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/authenticate/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/authenticate/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "authenticate";

package/dist/tools/authenticate/schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/download-attachment/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Download a specific email attachment and save it to disk. Use list_attachments first to get the attachment ID. To save several (or all) attachments from an email in one call, use download_attachments instead. Returns the full path where the file was saved.";
+export declare function handler({ messageId, attachmentId, saveTo }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/download-attachment/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/download-attachment/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "download_attachment";

package/dist/tools/download-attachment/schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    messageId: z.ZodString;
+    attachmentId: z.ZodString;
+    saveTo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/download-attachments/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Download multiple attachments from an email in a single call and save them to disk. Omit attachmentIds to download all file attachments. Returns the saved path for each file.";
+export declare function handler({ messageId, attachmentIds, saveTo, includeInline, }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/download-attachments/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/download-attachments/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "download_attachments";

package/dist/tools/download-attachments/schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    messageId: z.ZodString;
+    attachmentIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    saveTo: z.ZodOptional<z.ZodString>;
+    includeInline: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/get-email/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Get the full content of a specific email by its ID, including the complete body. To fetch several emails at once, use get_emails instead.";
+export declare function handler({ id }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/get-email/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/get-email/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY: "get_email";

package/dist/tools/get-email/schema.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/get-emails/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Get the full content of multiple emails by their IDs in a single batched request. Much faster than calling get_email repeatedly. Returns subject, sender, recipients, and complete body for each.";
+export declare function handler({ ids }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/get-emails/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/get-emails/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "get_emails";

package/dist/tools/get-emails/schema.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllTools(server: McpServer): void;

package/dist/tools/list-attachments/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "List all attachments for a specific email. Returns attachment IDs, names, sizes, and content types. Use download_attachment for one file, or download_attachments to save several (or all) in a single call.";
+export declare function handler({ messageId }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/list-attachments/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/list-attachments/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "list_attachments";

package/dist/tools/list-attachments/schema.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    messageId: z.ZodString;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/list-emails/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "List emails from an Outlook mailbox folder. Supports filtering by read status, sender, date range, and more using OData filter syntax. Use skip to page through results.";
+export declare function handler({ folder, top, skip, filter, orderby }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/list-emails/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/list-emails/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY: "list_emails";

package/dist/tools/list-emails/schema.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    folder: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    top: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    skip: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodString>;
+    orderby: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/list-folders/definition.d.ts

@@ -0,0 +1,7 @@
+export declare const description = "List all mail folders in the mailbox, including custom folders.";
+export declare function handler(_input: Record<string, never>): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/list-folders/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/list-folders/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY: "list_folders";

package/dist/tools/list-folders/schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/search-emails/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Search emails using a keyword query. Searches across subject, body, sender, and recipients.";
+export declare function handler({ query, top }: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/search-emails/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/search-emails/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY: "search_emails";

package/dist/tools/search-emails/schema.d.ts

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{
+    query: z.ZodString;
+    top: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/sign-out/definition.d.ts

@@ -0,0 +1,8 @@
+import type { Input } from './schema.js';
+export declare const description = "Sign out of the Microsoft account: removes the cached session from this machine and cancels any pending sign-in. After this, the authenticate tool must be run again before other tools work. Note: this clears the local token cache but does not revoke app consent in the Microsoft account.";
+export declare function handler(_input: Input): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/sign-out/index.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function register(server: McpServer): void;

package/dist/tools/sign-out/key.d.ts

@@ -0,0 +1 @@
+export declare const KEY = "sign_out";

package/dist/tools/sign-out/schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const schema: z.ZodObject<{}, z.core.$strip>;
+export type Input = z.infer<typeof schema>;

package/dist/tools/wrap.d.ts

@@ -0,0 +1,13 @@
+type ToolResult = {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+    isError?: boolean;
+};
+/**
+ * Wraps a tool handler so Graph/network errors come back as readable tool
+ * output instead of a raw stack trace.
+ */
+export declare function wrapHandler<I>(fn: (input: I) => Promise<ToolResult>): (input: I) => Promise<ToolResult>;
+export {};

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "outlook-reader-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MCP server for reading Outlook mail via Microsoft Graph: list, search, and fetch emails (batched), and download attachments.",
+  "main": "dist/mcp-server.js",
+  "types": "dist/mcp-server.d.ts",
+  "sideEffects": false,
   "bin": {
     "outlook-reader-mcp": "dist/mcp-server.js"
   },
@@ -12,6 +15,7 @@
     "mcp": "tsx src/mcp-server.ts",
     "build": "tsc",
     "prepublishOnly": "npm run format:check && npm run build",
+    "postversion": "git push --follow-tags",
     "format": "prettier --write .",
     "format:check": "prettier --check ."
   },