Jelly FastMCP

A FastMCP-based Model Context Protocol (MCP) server for the Jelly API. It exposes the API as MCP tools for creating, reading, updating, and managing conversations, labels, contacts, drafts, autoresponder settings, comments, and more.

Prerequisites

• Python 3.12+

• uv (recommended)

Related MCP server: FastMail MCP Server

Configuration

Configure the following environment variables to authenticate and set defaults:

Running

Direct execution

uv run server.py

Install editable

uv pip install -e .

This registers the jelly-mcp command.

Claude Desktop example

{
  "mcpServers": {
    "jelly-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "$HOME/.agents/Jelly-FastMCP",
        "run",
        "server.py"
      ],
      "env": {
        "JELLY_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Available tools

Conversations

• list_conversations

• search_conversations

• get_conversation

• list_conversation_messages

• list_conversation_comments

• add_comment

• archive_conversation / unarchive_conversation

• trash_conversation / restore_conversation_from_trash

• spam_conversation / unspam_conversation

• snooze_conversation / unsnooze_conversation

• ignore_conversation

• set_conversation_mailboxes

• assign_conversation / unassign_conversation

• add_conversation_label / remove_conversation_label

Messages and drafts

• get_message

• create_draft_conversation

• create_draft_reply

• update_draft

• resolve_attachment_download_url

Labels, members, and mailboxes

• list_labels

• create_label

• update_label

• delete_label

• list_members

• list_mailboxes

• list_mailbox_members

Contacts and settings

• find_contact_by_email

• upsert_contact

• get_autoresponder

• update_autoresponder

• list_saved_replies

Resources

• jelly://conversations/{conversation_id}/markdown — LLM-friendly markdown view of a conversation