Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Missive MCP server

Vendor MCP
Open markdown

The Missive MCP connector routes your AI agent's tool calls to Missive's own MCP server through Scalekit. Each user signs in to Missive once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 20 tools.

Tools
20
What they doRead · write · destructive
13 · 1 · 613 read1 write6 destructive
Users sign in with
OAuth app
Your own Missive MCP server app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Missive MCP connection

    In AgentKit > Connections, create a Missive MCP connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Missive MCP server connections use your own OAuth app. Register one with Missive MCP server and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Missive MCP connection.

  5. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'missivemcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Missive MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'missivemcp_get_contact_details',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • missivemcp_get_calendar_eventsFetch calendar events to check the user's availability.Read-only

    Get Calendar Events

    Fetch calendar events to check the user's availability. Use this tool when: - The conversation involves scheduling, meetings, or availability; - Someone asks about meeting times or when the user is free; - Drafting a reply that proposes meeting times; If calendar_ids is omitted, queries all accessible calendars. Use mode='availability' to get just busy time slots, or mode='full' for event details. IMPORTANT: When inferring dates from conversation context: - If a month is mentioned without a year, use the NEXT occurrence of that month (future, not past); - "Upcoming", "next", or future-tense language always means a date after today; - Check the current date before making assumptions about which year.

    Inputs

    end_datestringrequired
    End date in YYYY-MM-DD format
    start_datestringrequired
    Start date in YYYY-MM-DD format
    calendar_idsarray
    Array of calendar UUIDs to query. Omit to query all accessible calendars.
    modestring
    'full' (default) returns event details, 'availability' returns only busy time slots
    querystring
    Search query string (full mode only)
  • missivemcp_get_contact_detailsLook up contact details from contact books.Read-only

    Get Contact Details

    Look up contact details from contact books. Search by email, phone number, or general query (name, company, etc.). Returns up to 5 matching contacts.

    Inputs

    emailstring
    Exact email address
    phone_numberstring
    Phone number (digits only, e.g. 4187171866)
    querystring
    Name, company name, or any keyword to search
  • missivemcp_get_conversation_entriesFetch older entries for a conversation that was cropped.Read-only

    Get Conversation Entries

    Fetch older entries for a conversation that was cropped. Only call this when `next_entries_before` is present and you need more history.

    Inputs

    beforestringrequired
    Pass the `next_entries_before` value from a cropped conversation to fetch older entries
    conversation_idstringrequired
    Conversation ID to fetch entries for
    include_attachmentsboolean
    Include file attachments for each message, internal comment and post. Supported attachments are provided as files directly; oversized or unsupported attachments include metadata and a temporary download URL only.
  • missivemcp_get_conversationsFetch conversations by conversation IDs or shared label IDs.Read-only

    Get Conversations

    Fetch conversations by conversation IDs or shared label IDs. Only use this if you don't have a search term, otherwise use `search_conversations` to get the conversation IDs first. One of `conversation_ids`, `shared_label_ids`, `team_ids`, `email_account_ids`, or `generic_account_ids` is required. <conversation> headers and metadata are always included. Always assess first whether you need the full content or only the headers and metadata, and pass `include_content` accordingly. If you're asked to get a conversation in a specific mailbox, always use `mailbox_id` parameter. `total_count` and `unseen_count` reflect the number of conversations on all pages. If you need file attachments to get the context, reload the conversation with `include_attachments` parameter.

    Inputs

    include_contentbooleanrequired
    Fetch full content. Pass `false` if you know you only need headers and metadata.
    afterstring
    Only fetch conversations modified after this timestamp
    beforestring
    Only fetch conversations modified before this timestamp
    conversation_idsarray
    Array of conversation IDs to fetch (max 25)
    cursorstring
    Cursor to fetch conversations after. If `cursor` is provided, all parameters except `limit` and `include_content` and `include_attachments` are ignored and are repeated from the previous request.
    email_account_idsarray
    Filter by email account IDs.
    generic_account_idsarray
    Filter by generic account IDs.
    include_attachmentsboolean
    Include file attachments for each message, internal comment and post. Supported attachments are provided as files directly; oversized or unsupported attachments include metadata and a temporary download URL only.
    limitinteger
    Maximum number of conversations to fetch, max and default is 25
    mailbox_idstring
    Filter by mailbox ID. Only pass the ID from the mailbox record, otherwise use `search_mailboxes` tool first. For a team inbox, pass the mailbox ID from the team record.
    shared_label_idsarray
    Retrieve conversations with any of the specified shared label IDs (max 100). Only pass IDs from shared label records, otherwise use `search_shared_labels` tool first. For an email label (a mailbox ID that starts with `label-`), use `mailbox_id` instead.
    team_idsarray
    Retrieve conversations assigned to any of the specified team IDs.
    unseenboolean
    Set to `true` to only fetch unseen.
  • missivemcp_get_search_resultsPoll for additional results from a previously started conversation search.Read-only

    Get Search Results

    Poll for additional results from a previously started conversation search. Use this after search_conversations returns partial results (done="false"). Pass the search_id from the previous response.

    Inputs

    search_idstringrequired
    UUID from previous search_conversations call
  • missivemcp_list_calendarsList all calendars the user has access to.Read-only

    List Calendars

    List all calendars the user has access to. Returns calendar names, IDs, and ownership status (owned vs delegated/shared). Use this to discover which calendars to query for events.

    Inputs

    This tool takes no inputs.

  • missivemcp_list_organizationsList the organizations the user is a member of.Read-only

    List Organizations

    List the organizations the user is a member of.

    Inputs

    This tool takes no inputs.

  • missivemcp_search_conversationsSearch conversations across all connected accounts (email, chat, etc.).Read-only

    Search Conversations

    Search conversations across all connected accounts (email, chat, etc.). NEVER use this tool if the user didn't provide a search term string, use `get_conversations` instead. Supports filtering by email filters, internal/external scopes, and shared labels. If you need then to get full conversation content, use `get_conversations` with the conversation IDs. CRITICAL: This is KEYWORD search, NOT semantic search. Multi-word queries require ALL words to appear in the email - this usually FAILS. QUERY STRATEGY: 1. Extract the CORE searchable noun from the user's request 2. IGNORE qualifiers: "my", "last", "recent", "the", "about", "for" - these hurt the search 3. Use FILTERS (date, email) to narrow - not more keywords 4. If no/wrong results, expand to SYNONYMS (see below) SYNONYM EXPANSION - Start with most likely term, expand if no/wrong results: - invoice → receipt → bill → statement - quote → estimate → proposal → pricing - shipping → delivery → tracking → shipment - contract → agreement → terms - payment → paid → transaction → charge - order → purchase → confirmation EXAMPLES - User request → Correct approach: "Find my last utility invoice" → Start: query: "invoice" + since filter → No/wrong results? Try "bill", then "statement" "What was the contractor's quote?" → Start: query: "quote" → No/wrong results? Try "estimate", then "proposal" WRONG: query: "last utility invoice" (0 results - emails don't contain "last") RIGHT: query: "invoice" + filters → no/wrong results → try "bill" → try "statement" AVAILABLE FILTERS: - `email`: Conversations involving this address (sender OR recipient) - `from`/`to`: Specific email header fields - `since`/`before`: Date range (YYYY-MM-DD) - `has_attachments`: Only with attachments - `search_in_internal`: Search comments/posts/drafts only - `search_in_external`: Search emails/messages only - `mailbox_id`: Search conversations in the specified mailbox. Only pass the mailbox ID from the mailbox or team record, otherwise use `search_mailboxes` tool first. If you're asked to get a conversation in a specific mailbox, always use this parameter. Note: A conversation can have both internal comments AND external emails/messages. WORKFLOW: 1. Search with most likely term + filters 2. If done="false" → call get_search_results with search_id for more results 3. If too many results → add email/date filters 4. If no/wrong results → try next synonym from the list above 5. Once you have results → use get_conversations to fetch full content If you're unsure about filters, ASK the user for clarification rather than running a broad search. A narrow search that misses some results is better than a broad search that returns thousands. ASYNC BEHAVIOR: Search runs across multiple sources (Gmail, Office365, etc.). Initial results return quickly, but if done="false", call get_search_results with the returned search_id to get additional results as they arrive.

    Inputs

    querystringrequired
    Search query string
    beforestring
    Only before this date (YYYY-MM-DD)
    emailstring
    Filter to conversations involving this email address
    email_account_idsarray
    Search in the specified email account IDs.
    fromarray
    Search email FROM header (provider API search)
    generic_account_idsarray
    Search in the specified generic account IDs.
    has_attachmentsboolean
    Search only with attachments
    mailbox_idstring
    Search in the specified mailbox. Only pass the ID from the mailbox record, otherwise use `search_mailboxes` tool first
    search_in_externalboolean
    Search only in emails/messages (customer content)
    search_in_internalboolean
    Search only in comments/posts/drafts (team content)
    shared_label_idsarray
    Search with any of the specified shared label IDs.
    sincestring
    Only after this date (YYYY-MM-DD)
    team_idsarray
    Search in any of the specified team IDs.
    toarray
    Search email TO header (provider API search)
    unseenboolean
    Set to `true` to only fetch unseen.