IMAP MCP Server

Instructions

Implementation Reference

• src/imap_mcp/imap_client.py:851-859 (handler)

  The actual implementation of the start_watch method which initiates the watcher.

  def start_watch(self) -> bool:
      """Start permanent IDLE watch on INBOX, next, waiting, someday."""
      if not self.watcher:
          config_path = Path(self.config.get("_config_path", "config.json"))
          self.watcher = get_watcher(str(config_path))
  
      self.watcher.start()
      self.watching = True
      return True

• src/imap_mcp/server.py:387-391 (registration)

  Registration of the start_watch tool definition.

  make_tool(
      "start_watch",
      "Start permanent IDLE watch on INBOX, next, waiting, someday",
      {},
  ),

• src/imap_mcp/server.py:656-657 (handler)

  The handler logic in the server to invoke the start_watch method on the imap_client.

  elif name == "start_watch":
      return imap_client.start_watch()