Sync open source content 🐝 (from 9cff8d127dfec54c7ac42e2f349cd7f09c7ad581)

Author: beezythebot

docs/gram/gram-functions/add-oauth.mdx

@@ -0,0 +1,45 @@
+---
+title: Add OAuth
+description: Learn how to implement OAuth authentication in Gram Functions for secure third-party integrations.
+---
+
+Integrating OAuth into Gram Functions is a simple process.
+
+## Accessing the token
+
+```typescript filename="src/gram.ts"
+const gram = new Gram({
+  envSchema: {
+    GOOGLE_ACCESS_TOKEN: z.string().describe("Google OAuth2 access token"),
+  },
+  authInput: {
+    oauthVariable: "GOOGLE_ACCESS_TOKEN",
+  },
+})
+  .tool({
+    name: "search_files",
+    description:
+      "Search for PDF files in Google Drive. Takes a search query and returns matching files based on their filename.",
+  },
+  async execute(ctx, input) {
+    const token = ctx.env.GOOGLE_ACCESS_TOKEN;
+    return fetch(`https://www.googleapis.com/drive/v3/files`, {
+      headers: { Authorization: `Bearer ${token}` },
+    });
+  },
+});
+```
+
+The `authInput` object is used to specify which environment varibale should be populated with the OAuth token.
+Gram will then handle the OAuth exchange and automatically supply the token to your function.
+
+Note that this will only work if you follow the steps below to enable OAuth for your MCP server.
+
+## Adding OAuth to your MCP server
+
+Configuring OAuth for a toolset containing Gram Functions is the same as configuring OAuth for any other toolset.
+You can follow the steps in our [guide](/docs/gram/host-mcp/adding-oauth) to get started.
+
+## Caveats
+
+MCP servers can only have one authentication method. This means that toolsets cannot contain tools that require different forms of OAuth (though they can contain any number of tools that DO NOT require OAuth alongside tools of a single OAuth type).