TL;DR: Request an OAuth client ID and secret from Noded. In Gemini Enterprise, add a custom MCP server with the URL https://app.getnoded.ai/api/mcp/apps, OAuth 2.0, and the URLs, scopes, and credentials below. In Gemini CLI, add the same values to ~/.gemini/settings.json. Reads are read-only. Every write (an email, a message, a note, a CRM record, a workflow run) arrives as a recommendation that you approve or dismiss.
Which Gemini?
| Surface | Custom MCP servers | Who sets it up |
|---|---|---|
| Gemini Enterprise (Google Cloud) | Supported | A Google Cloud admin adds Noded as a custom MCP server data store, then users enable its actions. |
| Gemini Enterprise – Business edition | Supported | A team admin adds Noded under Connected apps. |
| Gemini CLI | Supported | Each user edits their own settings.json. |
| Gemini app (personal Google account) | Limited | Personal accounts in the US (18+) can add custom MCP servers for Gemini Spark in the web app. Not available on work or school accounts. |
What you need
- A Noded account with data connected. Gemini can only find what Noded has synced. Connect at least one source (Gmail, Google Calendar, Slack, a call recorder, or a CRM) in the Noded app first.
- An OAuth client ID and client secret from Noded. Gemini’s automatic (dynamic) registration does not complete against Noded’s sign-in service, so we issue credentials for your workspace. Email hello@getnoded.ai with the subject OAuth client for Gemini, the email address of your Noded workspace, and which Gemini surface you use. We reply with a client ID and a client secret, and we register Gemini’s callback URL for you.
- Admin access to Gemini Enterprise, if that is where you add it. Google’s guides: custom MCP server data store and custom MCP server in Business edition.
- The server URL.
https://app.getnoded.ai/api/mcp/apps- enter it exactly, including the path.
Using another assistant? See the guides for Claude, ChatGPT, and Microsoft Copilot Studio.
The OAuth values
Every Gemini surface asks for the same values. The client ID and client secret are the ones Noded sent you.
| Field | Value |
|---|---|
| MCP server URL | https://app.getnoded.ai/api/mcp/apps |
| Authorization URL | https://auth.getnoded.ai/authorize |
| Authorization URL parameters | audience=https://api.noded.so |
| Token URL | https://auth.getnoded.ai/oauth/token |
| Client ID | From Noded |
| Client secret | From Noded |
| Scopes | openid profile email noded.read noded.recommendations noded.write |
| PKCE | Enable it where the form offers it. |
The audience parameter matters. Without it, sign-in succeeds but Noded rejects the token.
Add Noded to Gemini Enterprise (Google Cloud)
1️⃣ Open data stores. In the Google Cloud console, go to Gemini Enterprise → Data stores → Create data store. Search for and select Custom MCP Server, then click Add MCP server. You need the Discovery Engine Editor role, and an organization policy may need to allow custom MCP servers.
2️⃣ Enter the server and OAuth settings. Set MCP Server URL to https://app.getnoded.ai/api/mcp/apps, choose OAuth 2.0, and fill in the values from the table above. Put audience=https://api.noded.so in Authorization URL Parameters, not in the authorization URL itself. Tick Enable PKCE Support. Save.
3️⃣ Enable the actions. By default no tools from a custom MCP server are enabled. Open the data store’s Actions tab, reload the list, and enable the Noded actions you want to expose. Then add the data store to your Gemini Enterprise app.
4️⃣ Sign in and test. In the Gemini Enterprise app, the first time Noded is called each user is asked to connect. Sign in with the same email address as your Noded account and approve the requested access. Then ask: “What can Noded do?”
Add Noded to Gemini Enterprise – Business edition
1️⃣ Open connected apps. Sign in to Gemini Enterprise – Business edition as a team admin. Click Settings & help, select your Team, then go to Manage team → Connected apps and click Add MCP Server.
2️⃣ Fill in the form. Under MCP info, set the name to Noded, add a short description (Customer context from Noded: people, accounts, emails, meetings, notes, tasks, and records, plus drafts for review), and set the URL to https://app.getnoded.ai/api/mcp/apps. Under Authentication settings, enter the values from the table above, with audience=https://api.noded.so in Authorization URL Parameters. Click Add.
3️⃣ Enable it. New MCP server connections start disabled. Enable the Noded connection on the Connected apps page so that your team can see it.
4️⃣ Sign in and test. Team members connect Noded from their own settings the first time it is used, sign in with their Noded email address, and approve the access. Then ask: “When did we last talk to Acme, and is anyone waiting on a reply from us?”
Add Noded to Gemini CLI
Add this to ~/.gemini/settings.json (or .gemini/settings.json in a project), with your client ID and secret:
| Step | What to do |
|---|---|
| Configure | { "mcpServers": { "noded": { "httpUrl": "https://app.getnoded.ai/api/mcp/apps", "oauth": { "enabled": true, "clientId": "YOUR_CLIENT_ID", "clientSecret": "YOUR_CLIENT_SECRET", "authorizationUrl": "https://auth.getnoded.ai/authorize?audience=https://api.noded.so", "tokenUrl": "https://auth.getnoded.ai/oauth/token", "scopes": ["openid", "profile", "email", "noded.read", "noded.recommendations", "noded.write"], "redirectUri": "http://localhost:7777/oauth/callback" } } } } |
| Sign in | Start Gemini CLI and run /mcp auth noded. A browser window opens for the Noded sign-in. |
| Check | Run /mcp to see the Noded tools, then ask: “What can Noded do?” |
The fixed redirectUri lets us register the callback for you. Tell us in your credentials request that you use Gemini CLI, and we register http://localhost:7777/oauth/callback (or another port if you say so). Keep the secret out of shared project files; the user-level ~/.gemini/settings.json is the right place.
What Gemini can do with Noded
Noded exposes one server with a small set of capability groups. You never need the tool names; describe what you want and Gemini picks the right one.
| Group | What it does | Example prompt |
|---|---|---|
| Find people and accounts | Resolves a name or company to the right contact or account, lists related people (buying committee, who else is involved), and reads your saved folders such as My Accounts. | “Who else at Acme has been on our calls?” |
| Read activity | Emails, chat messages, meetings and transcriptions, notes, tasks, and saved CRM or support records - filtered by person, account, date, direction, or status. Semantic search finds themes when exact filters are not enough. | “What was decided on the last two Acme calls?” |
| Check engagement | Per-account activity across every channel in one call, and unanswered emails - who is waiting on you, and who has gone quiet. | “Which of my accounts have gone quiet this month?” |
| Search connected apps | Read-only live lookups in the apps you have connected (Salesforce, HubSpot, Zendesk, Jira, Linear, and others) using the searches installed for your account. | “Find open Zendesk tickets for Acme.” |
| Draft and act | Draft an email, a Slack or Teams message, or a note; create a record in a connected system (a Jira issue, a Salesforce case, a HubSpot record); or run one of your installed workflows. Each one arrives as a recommendation to review. | “Draft a follow-up to Jane at Acme about next steps.” |
| Dates | Helpers for the current time, relative dates, and date arithmetic so questions such as “in the last 10 days” resolve correctly. | “How many days until the Acme renewal?” |
The exact list of searches, workflows, and record types is specific to your account. It depends on which apps you have connected in Noded and which queries and functions your team has installed. Ask “What can Noded do?” at any time to see the current list.
Gemini shows Noded results as text. The interactive result cards that Noded renders in Claude and ChatGPT are not shown in Gemini.
How the review step works
Noded separates reading from writing. All the read tools are read-only. Every write goes through a recommendation:
1️⃣ Gemini proposes. When you ask for an email, a message, a note, a record, or a workflow run, Gemini composes the proposal and asks Noded to create a recommendation. Nothing is sent, saved, created, or run at this point.
2️⃣ You review it. Gemini reports the recommendation in the chat: the recipients, the subject and body, the record fields, or the workflow inputs. The same recommendation appears in the Noded app, where you can edit the text before you decide.
3️⃣ Approve or dismiss. Approve accepts the recommendation with your edits, and Noded carries it out through the connected system. Dismiss discards it. If Noded cannot create a recommendation, Gemini tells you so instead of pretending the action happened.
Permissions and data handling
- The connection runs as you. Gemini sees only what your Noded user can see. Tenant boundaries and sharing permissions are the same as in the Noded app. Every colleague who uses the connection signs in to Noded separately.
- Sign-in is OAuth 2.0 authorization code with PKCE. Gemini never holds your Noded password. The token is scoped to reading your customer context and creating recommendations. The client secret identifies your Gemini connection to Noded; treat it like a password and share it only with the admin who sets it up.
- Disconnect at any time. Disable or remove the Noded connection in Gemini Enterprise, or delete the
nodedentry fromsettings.jsonin Gemini CLI. Email us to revoke the client entirely. - Nothing new is stored in Gemini by Noded. Query results are returned to the chat you are in and are governed by your Google Workspace or Google Cloud data policies.
Troubleshooting
- The sign-in window shows an error about a redirect URL. The callback URL Gemini uses is not yet on your client. Send us the exact URL from the error message and which Gemini surface you use.
- Sign-in succeeds but the tools return “Unauthorized”. Check that
audience=https://api.noded.sois present in the authorization URL parameters, and that you signed in with the same email address as your Noded account. - Gemini Enterprise shows no Noded tools. Open the data store’s Actions tab, reload, and enable the actions. In Business edition, check that the connection is enabled on Connected apps.
- Gemini CLI reports the server as disconnected. Run
/mcp auth nodedto sign in again. Tokens are stored in~/.gemini/mcp-oauth-tokens.json; delete thenodedentry there to start over. - Gemini finds nothing for an account you know is active. Check that the source (email, calendar, Slack, call recorder, CRM) is connected in Noded and has finished its first sync.
- Gemini answers from general knowledge instead of Noded. Say “use Noded” in the prompt, or make the server description more specific.
FAQ
Why do I need a client ID and client secret from Noded?
Gemini’s automatic (dynamic) OAuth registration does not complete against Noded’s sign-in service. We issue a client ID and client secret for your workspace instead, and you enter them in the Client ID and Client Secret fields of the custom MCP server form, or in the oauth block of Gemini CLI’s settings.json. The sign-in itself is the same standard OAuth flow.
Does the personal Gemini app support Noded?
Partly. Google now lets personal accounts in the US (18 or over) add custom MCP servers for Gemini Spark: in the Gemini web app, open Settings & help → Connected Apps → Custom apps for Spark, enter the server URL, and under Show more enter the client ID and secret Noded sent you. It is not available on work or school accounts, and we have not yet verified the full flow end to end - Gemini Enterprise and Gemini CLI are the paths we support today.
Can Gemini send an email or create a record through Noded without asking me?
No. Every write becomes a recommendation. Nothing is sent, saved, created, or run until you approve it.
Which URL do I enter?
https://app.getnoded.ai/api/mcp/apps, entered exactly, including the /api/mcp/apps path.
Does the same server work with Claude, ChatGPT, and Microsoft Copilot?
Yes. The same server URL is used for Claude, ChatGPT, and Microsoft Copilot Studio. See our guide to MCP for customer teams for the wider picture.