Finans-Mail-MCP 1.0.1 MCP tools and protocol inventory

Tools 6

Tool	Category	Annotations	Risk
extract_attachmentsExtract only attachments from an email file. Features: - Filter by MIME type (e.g., 'image/', 'application/pdf') - Option to include/exclude embedded images (CID attachments) - Returns filename, size, MIME type, and optional content Useful when you only need attachments without full email parsing. Input schema { "type": "object", "properties": { "content": { "type": "string", "description": "Base64 encoded email file content" }, "fileName": { "type": "string", "description": "Original filename with extension" }, "filterByMimeType": { "type": "string", "description": "Filter attachments by MIME type prefix (e.g., 'image/')" }, "includeEmbedded": { "type": "boolean", "description": "Include embedded images/CID attachments (default: true)" } }, "required": [ "content", "fileName" ] }	—	— · —	—
format_email_contentFormat and clean email content for display. Features: - Clean up HTML (remove scripts, sanitize) - Convert plain text to formatted HTML - Replace CID URLs with data URIs for embedded images Use after parsing to prepare content for rendering. Input schema { "type": "object", "properties": { "htmlContent": { "type": "string", "description": "HTML content to clean up" }, "textContent": { "type": "string", "description": "Plain text to convert to HTML" }, "attachments": { "type": "array", "items": { "type": "object", "properties": { "filename": { "type": "string" }, "contentId": { "type": "string" }, "content": { "type": "string" }, "mimeType": { "type": "string" } }, "required": [ "filename" ] }, "description": "Attachments for CID URL replacement" } }, "required": [] }	—	— · —	—
get_email_metadataGet only metadata from an email without full content parsing. Returns lightweight info: - Subject - Sender name and email - Recipients - Dates - Priority - Attachment count (without content) Faster than full parsing when you only need headers. Input schema { "type": "object", "properties": { "content": { "type": "string", "description": "Base64 encoded email file content" }, "fileName": { "type": "string", "description": "Original filename with extension" } }, "required": [ "content", "fileName" ] }	—	— · —	—
get_supported_formatsGet list of supported email file formats and their descriptions. Returns information about: - File extensions supported - Format descriptions - Typical use cases Input schema { "type": "object", "properties": {}, "required": [] }	—	— · —	—
parse_emailParse a Microsoft Outlook email file (MSG, EML, or OFT format) and extract all content. Returns: - Subject, sender, recipients (to, cc, bcc) - Sent/received dates - Priority and importance levels - Plain text and HTML content - All attachments with optional base64 content Supported formats: - .msg - Microsoft Outlook Message - .eml - Standard email format (RFC 822) - .oft - Outlook Template (same as MSG) Input schema { "type": "object", "properties": { "content": { "type": "string", "description": "Base64 encoded email file content" }, "fileName": { "type": "string", "description": "Original filename with extension (.msg, .eml, .oft)" }, "includeAttachmentContent": { "type": "boolean", "description": "Include base64 attachment content in response (default: true)" }, "maxAttachmentSize": { "type": "number", "description": "Max attachment size in bytes to include content (default: 10MB)" } }, "required": [ "content", "fileName" ] }	—	— · —	—
validate_email_fileValidate if a file is a valid Outlook email format. Checks: - MSG files: Validates CFB (Compound File Binary) signature - EML files: Validates RFC 822 email headers Use this before parsing to ensure file compatibility. Input schema { "type": "object", "properties": { "content": { "type": "string", "description": "Base64 encoded file content to validate" }, "expectedType": { "type": "string", "enum": [ "msg", "eml", "any" ], "description": "Expected file type to validate against (default: any)" } }, "required": [ "content" ] }	—	— · —	—

Resources 8

Complete Application Example

Full-featured email viewer application code

Metadata

{
  "resource_key": "outlook://examples/complete-app",
  "uri": "outlook://examples/complete-app",
  "name": "Complete Application Example",
  "description": "Full-featured email viewer application code",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "a4523bb0762b2185a4571bc4ffa3785ac574a867420f79ad1d0501ded0c6ed0e"
}

Error Handling Patterns

Robust error handling for email parsing

Metadata

{
  "resource_key": "outlook://patterns/error-handling",
  "uri": "outlook://patterns/error-handling",
  "name": "Error Handling Patterns",
  "description": "Robust error handling for email parsing",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "768ded086510172ffd8c2829a5f39124c5a908c808d18dbe05e3bcec4be807ca"
}

Next.js Integration Pattern

Best practices for using outlook packages in Next.js apps

Metadata

{
  "resource_key": "outlook://patterns/nextjs",
  "uri": "outlook://patterns/nextjs",
  "name": "Next.js Integration Pattern",
  "description": "Best practices for using outlook packages in Next.js apps",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "f7650ed65fa04b89059e7bb9cac4e442b665ec08124150c947fcb583974ea5be"
}

outlook-email-parser Documentation

Complete guide to parsing MSG, EML, OFT email files with examples

Metadata

{
  "resource_key": "outlook://docs/outlook-email-parser",
  "uri": "outlook://docs/outlook-email-parser",
  "name": "outlook-email-parser Documentation",
  "description": "Complete guide to parsing MSG, EML, OFT email files with examples",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "03ae49dab7ea6524cc1dae9f072d4fe57801b6ba6f10808518a7298ca184630c"
}

outlook-reader-ui Documentation

React hooks and components for displaying parsed emails

Metadata

{
  "resource_key": "outlook://docs/outlook-reader-ui",
  "uri": "outlook://docs/outlook-reader-ui",
  "name": "outlook-reader-ui Documentation",
  "description": "React hooks and components for displaying parsed emails",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "3f491373dcaae4ba110a52ab583a58b8bb74563edb9739e5af87df233c0ff549"
}

Performance Optimization

Tips for handling large files and batch processing

Metadata

{
  "resource_key": "outlook://patterns/performance",
  "uri": "outlook://patterns/performance",
  "name": "Performance Optimization",
  "description": "Tips for handling large files and batch processing",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "4c665b7b7eb831b6ac8eec1d92fd24949d9dcf54e87af73f7dcc54dd9ed0ee79"
}

Quick Start Guide

Complete example app parsing and displaying Outlook emails

Metadata

{
  "resource_key": "outlook://docs/quick-start",
  "uri": "outlook://docs/quick-start",
  "name": "Quick Start Guide",
  "description": "Complete example app parsing and displaying Outlook emails",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "7c0abaf1f3a6508c745fe568cced29fc9bfb2e6960839eb06a8956fa5e16f155"
}

TypeScript Types

All TypeScript interfaces and types for both packages

Metadata

{
  "resource_key": "outlook://types/all",
  "uri": "outlook://types/all",
  "name": "TypeScript Types",
  "description": "All TypeScript interfaces and types for both packages",
  "mime_type": "text/markdown",
  "annotations": null,
  "metadata_hash": "90ee38f201717b93f2315f82617e422c2893223084949223105288a848ee8a08"
}

Prompts 5

build-email-api

Generate a backend API endpoint for parsing uploaded email files

Metadata

{
  "prompt_key": "build-email-api",
  "name": "build-email-api",
  "description": "Generate a backend API endpoint for parsing uploaded email files",
  "arguments": [
    {
      "name": "framework",
      "description": "Backend framework: 'nextjs-api', 'express', 'fastify', or 'hono'",
      "required": false
    },
    {
      "name": "validation",
      "description": "Include file validation: 'true' or 'false'",
      "required": false
    }
  ],
  "metadata_hash": "9524e07cc077b4b2c088afb9c8030e248473be00341a132599f5566e93651105"
}

build-email-viewer

Generate a complete React component for viewing Outlook emails with file upload

Metadata

{
  "prompt_key": "build-email-viewer",
  "name": "build-email-viewer",
  "description": "Generate a complete React component for viewing Outlook emails with file upload",
  "arguments": [
    {
      "name": "framework",
      "description": "React framework: 'nextjs', 'vite', or 'cra'",
      "required": false
    },
    {
      "name": "styling",
      "description": "Styling approach: 'tailwind', 'css-modules', or 'styled-components'",
      "required": false
    },
    {
      "name": "features",
      "description": "Comma-separated features: 'dark-mode', 'attachments', 'search', 'print'",
      "required": false
    }
  ],
  "metadata_hash": "44a0a56c3fa5e26399b107007a7e192cc936c7f641e270f78260a8f469837c02"
}

extract-email-data

Generate code to extract specific data from emails (contacts, dates, attachments)

Metadata

{
  "prompt_key": "extract-email-data",
  "name": "extract-email-data",
  "description": "Generate code to extract specific data from emails (contacts, dates, attachments)",
  "arguments": [
    {
      "name": "extract",
      "description": "What to extract: 'contacts', 'attachments', 'links', 'dates', or 'all'",
      "required": true
    }
  ],
  "metadata_hash": "76e6fd1c40a92929385b483dd17bff76fd4f934eb24c0a949aa1abd90fa6858e"
}

parse-email-batch

Generate code to parse multiple email files from a directory

Metadata

{
  "prompt_key": "parse-email-batch",
  "name": "parse-email-batch",
  "description": "Generate code to parse multiple email files from a directory",
  "arguments": [
    {
      "name": "output",
      "description": "Output format: 'json', 'csv', or 'database'",
      "required": false
    }
  ],
  "metadata_hash": "728d97a35dd727af55a7a5fa1f3c99ecde5c578723a55c5c5705ddf5fe6927f8"
}

troubleshoot-parsing

Help diagnose and fix email parsing issues

Metadata

{
  "prompt_key": "troubleshoot-parsing",
  "name": "troubleshoot-parsing",
  "description": "Help diagnose and fix email parsing issues",
  "arguments": [
    {
      "name": "error",
      "description": "The error message or issue description",
      "required": true
    },
    {
      "name": "fileType",
      "description": "File type: 'msg', 'eml', or 'unknown'",
      "required": false
    }
  ],
  "metadata_hash": "61496f0b693320be891b248ff14eef7d10f155fa47b9cf5c450a7ebc6d88cdce"
}

Finans-Mail-MCP `1.0.1`

Observation

Tools 6

Resources 8

Resource templates 0

Prompts 5

Let’s talk about MCP security.