grncdr/missive-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

4 stars 12 forks 品質 61 トレンド 12

Repository Install

A remote MCP server for interacting with Missive

概要

An MCP (Model Context Protocol) server that interfaces with the Missive API, enabling Claude to manage email conversations, contacts, and team collaboration. - Node.js 18+ - Missive account with (required for API access) - Missive API token The server runs in two modes: for local single-user use, and for hosted multi-user deployments. Set the MISSIVE_API_TOKEN environment variable: To get your API token: open Missive, go to Settings > API, click "Create a new token". Add to your Claude Desktop configuration (claude_desktop_config.json): Use the full path to node (run which node to find it). Claude Desktop has a restricted PATH and may not find node otherwise. Runs an HTTP server with OAuth. Each user provides their own Missive PAT through a browser-based authorization flow.

README

以下は原文 README の抜粋です。原文を見る。

Missive MCP Server

An MCP (Model Context Protocol) server that interfaces with the Missive API, enabling Claude to manage email conversations, contacts, and team collaboration.

Prerequisites

Node.js 18+
Missive account with Productive plan (required for API access)
Missive API token

Installation

npm install
npm run build

Modes

The server runs in two modes: stdio for local single-user use, and remote for hosted multi-user deployments.

Stdio Mode (Local)

Set the MISSIVE_API_TOKEN environment variable:

export MISSIVE_API_TOKEN="your_api_token_here"
npm start

To get your API token: open Missive, go to Settings > API, click “Create a new token”.

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "missive": {
      "command": "/path/to/node",
      "args": ["/path/to/missive-mcp/dist/index.js"],
      "env": {
        "MISSIVE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Important: Use the full path to node (run which node to find it). Claude Desktop has a restricted PATH and may not find node otherwise.

Remote Mode (Hosted)

Runs an HTTP server with OAuth. Each user provides their own Missive PAT through a browser-based authorization flow.

export ENCRYPTION_KEY="$(openssl rand -hex 32)"
export BASE_URL="https://missive-mcp.example.com"
npm run remote

Variable	Required	Description
`ENCRYPTION_KEY`	Yes	32-byte hex string for AES-256-GCM PAT encryption
`BASE_URL`	Yes	Public URL of the server
`PORT`	No	HTTP port (default 3000)
`DATA_DIR`	No	Directory for storage files (default `./data`)

Point MCP clients at {BASE_URL}/mcp. The server handles OAuth automatically:

Client discovers endpoints via /.well-known/oauth-authorization-server
Client registers dynamically via /register
User is redirected to a form to paste their Missive API token
Server validates the token, encrypts and stores it, issues OAuth tokens
Client uses bearer tokens to call /mcp

PATs are encrypted at rest with AES-256-GCM. OAuth tokens expire after 1 hour (refresh tokens last 30 days).

Tools

Reference Data

Tool	Description
`list_organizations`	List organizations you belong to
`list_teams`	List teams (for assignments)
`list_users`	List users (for assignments)
`list_contact_books`	List contact books (required before creating contacts)
`list_shared_labels`	List labels (for filtering and tagging)

Conversations

Tool	Description
`list_conversations`	List conversations with filters (inbox, assigned, closed, team, label, email, domain)
`get_conversation`	Get a single conversation by ID

Messages

Tool	Description

GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
  "mcpServers": {
    "missive": {
      "command": "/path/to/node",
      "args": ["/path/to/missive-mcp/dist/index.js"],
      "env": {
        "MISSIVE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}