IMAP MCP Server

Instructions

Implementation Reference

• src/imap_mcp/imap_client.py:841-849 (handler)

  The actual implementation of the refresh_cache tool.

  def refresh_cache(self) -> bool:
      """Force refresh of email cache for all watched mailboxes."""
      if self.watcher and self.watcher.running:
          self.watcher.refresh()
      else:
          self.cache.clear()
          self.cache_timestamps.clear()
          self.get_cached_overview()
      return True

• src/imap_mcp/server.py:382-386 (registration)

  The MCP tool registration for refresh_cache.

  make_tool(
      "refresh_cache",
      "Force refresh of email cache for all watched mailboxes",
      {},
  ),

• src/imap_mcp/server.py:654-655 (handler)

  The tool handler logic that calls the imap_client implementation.

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