p1v1-mcp-server

quangtm08/p1v1-mcp-server

3.2

If you are the rightful owner of p1v1-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Dream Mail MCP Server is a Model Context Protocol server designed for seamless Gmail integration with the Dream Mail dashboard, offering tools for email management, automation, and integration with Supabase and n8n workflows.

Tools
5
Resources
0
Prompts
0

Dream Mail MCP Server

A Model Context Protocol (MCP) server for Gmail integration with the Dream Mail dashboard. This server provides tools for email management, automation, and integration with Supabase and n8n workflows.

Features

  • Gmail API Integration: Fetch, label, and archive emails
  • Supabase Integration: Store email metadata and user preferences
  • MCP Tools: Standardized tools for email operations
  • Webhook Support: Handle Gmail push notifications
  • n8n Integration: Trigger automation workflows

Setup

Prerequisites

  • Node.js 18+
  • Gmail API credentials
  • Supabase project
  • n8n instance (optional)

Installation

  1. Clone the repository:
git clone <repository-url>
cd dream-mail-mcp-server
  1. Install dependencies:
npm install
  1. Copy environment variables:
cp env.example .env

  1. Configure your environment variables in .env

  2. Build the project:

npm run build
  1. Start the server:
npm start

Development

For development with hot reload:

npm run dev

Environment Variables

See env.example for all required environment variables.

MCP Tools

The server provides the following MCP tools:

  • get_emails: Fetch emails from Gmail
  • create_label: Create Gmail labels
  • archive_email: Archive emails
  • classify_email: Classify emails using AI
  • apply_rules: Apply custom email rules

API Endpoints

  • POST /webhook/gmail: Gmail push notification endpoint
  • GET /health: Health check endpoint

Architecture

src/
├── index.ts                 # MCP server entry point
├── gmail/
│   ├── client.ts           # Gmail API client
│   ├── auth.ts             # Token management
│   └── webhook.ts          # Gmail push notifications
├── database/
│   ├── supabase.ts         # Database connection
│   └── models.ts           # Data models
└── mcp/
    ├── server.ts           # MCP server setup
    └── tools/
        ├── getEmails.ts    # MCP tool for fetching emails
        ├── createLabel.ts  # MCP tool for creating labels
        └── archiveEmail.ts # MCP tool for archiving

License

MIT