twist_inbox_get
Retrieve your Twist inbox threads with filters for date ranges, archive status, ordering, and exclusions to manage conversations.
Instructions
Get the authenticated user's inbox.
Args: limit: Limits the number of threads returned (default is 30, maximum is 500) newer_than_ts: Limits threads to those newer when the specified Unix time older_than_ts: Limits threads to those older when the specified Unix time archive_filter: Filter threads based on their is_archived flag: 'all', 'archived', or 'active' (default) order_by: Order of threads: 'desc' (default) or 'asc', based on last_updated attribute exclude_thread_ids: Thread IDs to exclude from results
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| newer_than_ts | No | ||
| older_than_ts | No | ||
| archive_filter | No | ||
| order_by | No | ||
| exclude_thread_ids | No |
Implementation Reference
- src/inbox.py:12-66 (handler)The core handler function that implements the logic for retrieving the user's inbox threads from the Twist API, including parameter handling and error management.def twist_inbox_get( ctx: Context, limit: Optional[int] = None, newer_than_ts: Optional[int] = None, older_than_ts: Optional[int] = None, archive_filter: Optional[str] = None, order_by: Optional[str] = None, exclude_thread_ids: Optional[List[int]] = None ) -> str: """Get the authenticated user's inbox. Args: limit: Limits the number of threads returned (default is 30, maximum is 500) newer_than_ts: Limits threads to those newer when the specified Unix time older_than_ts: Limits threads to those older when the specified Unix time archive_filter: Filter threads based on their is_archived flag: 'all', 'archived', or 'active' (default) order_by: Order of threads: 'desc' (default) or 'asc', based on last_updated attribute exclude_thread_ids: Thread IDs to exclude from results """ token = ctx.request_context.lifespan_context.twist_token workspace_id = os.getenv("TWIST_WORKSPACE_ID") if not workspace_id: logger.error("TWIST_WORKSPACE_ID environment variable is required") return "Error: TWIST_WORKSPACE_ID environment variable is required" params = {"workspace_id": workspace_id} if limit is not None: params["limit"] = limit if newer_than_ts is not None: params["newer_than_ts"] = newer_than_ts if older_than_ts is not None: params["older_than_ts"] = older_than_ts if archive_filter is not None: params["archive_filter"] = archive_filter if order_by is not None: params["order_by"] = order_by if exclude_thread_ids is not None: params["exclude_thread_ids"] = exclude_thread_ids try: logger.info(f"Getting inbox for workspace ID: {workspace_id}") inbox_data = twist_request("inbox/get", params=params, token=token) if not inbox_data: logger.info("No inbox threads found") return "No inbox threads found" logger.info(f"Retrieved {len(inbox_data)} inbox threads") return inbox_data except Exception as error: logger.error(f"Error getting inbox: {error}") return f"Error getting inbox: {str(error)}"
- main.py:42-48 (registration)Dynamic registration code that discovers and registers all functions prefixed with 'twist_' from inbox.py and threads.py modules as MCP tools, including twist_inbox_get.# Register all tools from tool modules for module in [src.inbox, src.threads]: for name, func in inspect.getmembers(module, inspect.isfunction): if name.startswith('twist_') and func.__module__ == module.__name__: logger.info(f"Registering tool: {name}") mcp.tool()(func)