diff --git a/docs/features/plugin/tools/development.mdx b/docs/features/plugin/tools/development.mdx
index fdd02768..4475124c 100644
--- a/docs/features/plugin/tools/development.mdx
+++ b/docs/features/plugin/tools/development.mdx
@@ -65,6 +65,9 @@ Below is a list of optional arguments your tools can depend on:
 - `__messages__`: List of previous messages
 - `__files__`: Attached files
 - `__model__`: A dictionary with model information
+- `__oauth_token__`: A dictionary containing the user's valid, automatically refreshed OAuth token payload. This is the **new, recommended, and secure** way to access user tokens for making authenticated API calls. The dictionary typically contains `access_token`, `id_token`, and other provider-specific data.
+
+For more information about `__oauth_token__` and how to configure this token to be sent to tools, check out the OAuth section in the [environment variable docs page](https://docs.openwebui.com/getting-started/env-configuration/) and the [SSO documentation](https://docs.openwebui.com/features/sso/).
 
 Just add them as argument to any method of your Tool class just like `__user__` in the example above.