> Note: This page is part of the DataDoe Docs. You can find the root of the documentation at `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe`.
> JSON Table of Contents: `https://www.datadoe.com/hub/docs/toc.json`.
> Data Scheme (Markdown index, one page per table): https://api.datadoe.com/api/v1/spec/data-scheme.md. Full JSON: https://api.datadoe.com/api/v1/spec/data-scheme.
> Actions (Markdown, every Action type with limits and group guides): https://api.datadoe.com/api/v1/spec/action-scheme.md. Full JSON with input schemas: https://api.datadoe.com/api/v1/spec/action-scheme.
> Other pages in the DataDoe Docs:
> - DataDoe Basics/Benefits: `https://www.datadoe.com/hub/docs/basics/benefits.md`
> - DataDoe Basics/Connecting Accounts: `https://www.datadoe.com/hub/docs/basics/connecting-accounts.md`
> - DataDoe Basics/External Invitation Links: `https://www.datadoe.com/hub/docs/basics/external-invitation-links.md`
> - DataDoe Basics/Groups: `https://www.datadoe.com/hub/docs/basics/groups.md`
> - DataDoe Basics/Integrations: `https://www.datadoe.com/hub/docs/basics/integration-customization.md`
> - DataDoe Basics/Introduction to DataDoe: `https://www.datadoe.com/hub/docs/basics/introduction-to-datadoe.md`
> - DataDoe Basics/Keys and service accounts: `https://www.datadoe.com/hub/docs/basics/keys-and-service-accounts.md`
> - DataDoe Basics/Roles and permissions: `https://www.datadoe.com/hub/docs/basics/roles-and-permissions.md`
> - DataDoe Basics/Subscription and pricing: `https://www.datadoe.com/hub/docs/basics/subscription-pricing.md`
> - DataDoe Basics/Users and access: `https://www.datadoe.com/hub/docs/basics/access-user-management.md`
> - DataDoe Data/Ads Product Catalog: `https://www.datadoe.com/hub/docs/datadoe-data/ads-product-catalog.md`
> - DataDoe Data/Amazon Ads Partner Opportunities: `https://www.datadoe.com/hub/docs/datadoe-data/amazon-ads-partner-opportunities.md`
> - DataDoe Data/Data Fetch Periods: `https://www.datadoe.com/hub/docs/datadoe-data/data-fetch-periods.md`
> - DataDoe Data/Data Sources: `https://www.datadoe.com/hub/docs/datadoe-data/data-sources.md`
> - DataDoe Data/Initial Loads: `https://www.datadoe.com/hub/docs/datadoe-data/initial-loads.md`
> - DataDoe Data/Managing Data Tables: `https://www.datadoe.com/hub/docs/datadoe-data/managing-data-tables.md`
> - DataDoe Data/Migrating from SellerBoard: `https://www.datadoe.com/hub/docs/datadoe-data/migrating-from-sellerboard.md`
> - DataDoe Data/SAT migration to profit tables: `https://www.datadoe.com/hub/docs/datadoe-data/sat-migration-to-profit-tables.md`
> - DataDoe Data/SQP Data: `https://www.datadoe.com/hub/docs/datadoe-data/search-query-performance.md`
> - DataDoe Data/Timezones: `https://www.datadoe.com/hub/docs/datadoe-data/orders-purchase-date-timezones.md`
> - DataDoe Data/Uploading COGS: `https://www.datadoe.com/hub/docs/datadoe-data/uploading-cogs.md`
> - DataDoe Data/Uploading KDP Royalty Parameters: `https://www.datadoe.com/hub/docs/datadoe-data/uploading-kdp-royalty-parameters.md`
> - DataDoe Data/Uploading Vendor Codes: `https://www.datadoe.com/hub/docs/datadoe-data/uploading-vendor-codes.md`
> - DataDoe Features/Amazon Marketing Cloud: `https://www.datadoe.com/hub/docs/datadoe-features/amc.md`
> - DataDoe Features/AMC query templates: `https://www.datadoe.com/hub/docs/datadoe-features/amc-query-templates.md`
> - DataDoe Features/Features Overview: `https://www.datadoe.com/hub/docs/datadoe-features/overview.md`
> - DataDoe Features/Files: `https://www.datadoe.com/hub/docs/datadoe-features/files.md`
> - DataDoe Features/Plugins: `https://www.datadoe.com/hub/docs/datadoe-features/plugins.md`
> - DataDoe Features/Usage Logs: `https://www.datadoe.com/hub/docs/datadoe-features/usage-logs.md`
> - DataDoe Actions/Action types: A+ Content: `https://www.datadoe.com/hub/docs/datadoe-actions/types/aplus-content.md`
> - DataDoe Actions/Action types: Action items and plans: `https://www.datadoe.com/hub/docs/datadoe-actions/types/action-items.md`
> - DataDoe Actions/Action types: Amazon Ads Account communication: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-account-communication.md`
> - DataDoe Actions/Action types: Amazon Ads Attribution: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-attribution.md`
> - DataDoe Actions/Action types: Amazon Ads Audiences: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-audiences.md`
> - DataDoe Actions/Action types: Amazon Ads Brands and creative assets: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-brands-creative-assets.md`
> - DataDoe Actions/Action types: Amazon Ads Budget and bid rules: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-budget-bid-rules.md`
> - DataDoe Actions/Action types: Amazon Ads Campaign management: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-campaign-management.md`
> - DataDoe Actions/Action types: Amazon Ads Partner opportunities: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-partner-opportunities.md`
> - DataDoe Actions/Action types: Amazon Ads Recommendations and insights: `https://www.datadoe.com/hub/docs/datadoe-actions/types/ads-recommendations-insights.md`
> - DataDoe Actions/Action types: Balances and payouts: `https://www.datadoe.com/hub/docs/datadoe-actions/types/finances.md`
> - DataDoe Actions/Action types: Buyer messaging: `https://www.datadoe.com/hub/docs/datadoe-actions/types/buyer-messaging.md`
> - DataDoe Actions/Action types: External Fulfillment shipping: `https://www.datadoe.com/hub/docs/datadoe-actions/types/external-fulfillment.md`
> - DataDoe Actions/Action types: FBA and MCF: `https://www.datadoe.com/hub/docs/datadoe-actions/types/fba-mcf.md`
> - DataDoe Actions/Action types: FBA inbound shipments: `https://www.datadoe.com/hub/docs/datadoe-actions/types/fba-inbound.md`
> - DataDoe Actions/Action types: FBM shipping and tracking: `https://www.datadoe.com/hub/docs/datadoe-actions/types/fbm-shipping.md`
> - DataDoe Actions/Action types: Listings: `https://www.datadoe.com/hub/docs/datadoe-actions/types/listings.md`
> - DataDoe Actions/Action types: Orders: `https://www.datadoe.com/hub/docs/datadoe-actions/types/orders.md`
> - DataDoe Actions/Action types: Vendor Direct Fulfillment: `https://www.datadoe.com/hub/docs/datadoe-actions/types/vendor-direct-fulfillment.md`
> - DataDoe Actions/Action types: Vendor purchase orders: `https://www.datadoe.com/hub/docs/datadoe-actions/types/vendor-purchase-orders.md`
> - DataDoe Actions/Actions: External Fulfillment: `https://www.datadoe.com/hub/docs/datadoe-actions/external-fulfillment.md`
> - DataDoe Actions/Actions: FBA eligibility: `https://www.datadoe.com/hub/docs/datadoe-actions/fba-eligibility.md`
> - DataDoe Actions/Actions: FBA inbound: `https://www.datadoe.com/hub/docs/datadoe-actions/fba-inbound.md`
> - DataDoe Actions/Actions: Introduction: `https://www.datadoe.com/hub/docs/datadoe-actions/introduction.md`
> - DataDoe Actions/Actions: KDP authors: `https://www.datadoe.com/hub/docs/datadoe-actions/kdp-authors.md`
> - DataDoe Actions/Actions: Listing images: `https://www.datadoe.com/hub/docs/datadoe-actions/listing-images.md`
> - DataDoe Webhooks/Webhooks: Business: `https://www.datadoe.com/hub/docs/datadoe-webhooks/business.md`
> - DataDoe Webhooks/Webhooks: Introduction: `https://www.datadoe.com/hub/docs/datadoe-webhooks/introduction.md`
> - DataDoe Webhooks/Webhooks: Platform: `https://www.datadoe.com/hub/docs/datadoe-webhooks/platform.md`
> - DataDoe MCP/Overview: `https://www.datadoe.com/hub/docs/datadoe-mcp/overview.md`
> - DataDoe MCP/Using Antigravity: `https://www.datadoe.com/hub/docs/datadoe-mcp/antigravity.md`
> - DataDoe MCP/Using ChatGPT: `https://www.datadoe.com/hub/docs/datadoe-mcp/chatgpt.md`
> - DataDoe MCP/Using Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude.md`
> - DataDoe MCP/Using Claude Agent SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-agents-sdk.md`
> - DataDoe MCP/Using Claude Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/claude-code.md`
> - DataDoe MCP/Using Codex: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex.md`
> - DataDoe MCP/Using Codex Sites: `https://www.datadoe.com/hub/docs/datadoe-mcp/codex-sites.md`
> - DataDoe MCP/Using CrewAI: `https://www.datadoe.com/hub/docs/datadoe-mcp/crewai.md`
> - DataDoe MCP/Using Cursor: `https://www.datadoe.com/hub/docs/datadoe-mcp/cursor.md`
> - DataDoe MCP/Using Excel + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/excel.md`
> - DataDoe MCP/Using Gemini CLI: `https://www.datadoe.com/hub/docs/datadoe-mcp/gemini-cli.md`
> - DataDoe MCP/Using Genspark: `https://www.datadoe.com/hub/docs/datadoe-mcp/genspark.md`
> - DataDoe MCP/Using Glama: `https://www.datadoe.com/hub/docs/datadoe-mcp/glama-chat.md`
> - DataDoe MCP/Using Glama MCP Inspector: `https://www.datadoe.com/hub/docs/datadoe-mcp/glama.md`
> - DataDoe MCP/Using Grok: `https://www.datadoe.com/hub/docs/datadoe-mcp/grok.md`
> - DataDoe MCP/Using GrokBot: `https://www.datadoe.com/hub/docs/datadoe-mcp/grokbot.md`
> - DataDoe MCP/Using Gumloop: `https://www.datadoe.com/hub/docs/datadoe-mcp/gumloop.md`
> - DataDoe MCP/Using Hermes Agent: `https://www.datadoe.com/hub/docs/datadoe-mcp/hermes.md`
> - DataDoe MCP/Using Littlebird: `https://www.datadoe.com/hub/docs/datadoe-mcp/littlebird.md`
> - DataDoe MCP/Using Muse: `https://www.datadoe.com/hub/docs/datadoe-mcp/muse.md`
> - DataDoe MCP/Using n8n: `https://www.datadoe.com/hub/docs/datadoe-mcp/n8n.md`
> - DataDoe MCP/Using NanoClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/nanoclaw.md`
> - DataDoe MCP/Using OpenAI Agents SDK: `https://www.datadoe.com/hub/docs/datadoe-mcp/openai-agents-sdk.md`
> - DataDoe MCP/Using OpenClaw: `https://www.datadoe.com/hub/docs/datadoe-mcp/openclaw.md`
> - DataDoe MCP/Using OpenCode: `https://www.datadoe.com/hub/docs/datadoe-mcp/opencode.md`
> - DataDoe MCP/Using PowerPoint + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/powerpoint.md`
> - DataDoe MCP/Using Superhuman: `https://www.datadoe.com/hub/docs/datadoe-mcp/superhuman.md`
> - DataDoe MCP/Using VS Code: `https://www.datadoe.com/hub/docs/datadoe-mcp/vs-code.md`
> - DataDoe MCP/Using Word + Claude: `https://www.datadoe.com/hub/docs/datadoe-mcp/word.md`
> - DataDoe API/Build with Codex: `https://www.datadoe.com/hub/docs/datadoe-api/codex.md`
> - DataDoe API/How to connect to the API: `https://www.datadoe.com/hub/docs/datadoe-api/how-to-connect.md`
> - DataDoe API/Invitation links API: `https://www.datadoe.com/hub/docs/datadoe-api/invitation-links.md`
> - DataDoe API/Sellers and vendors API: `https://www.datadoe.com/hub/docs/datadoe-api/sellers-and-vendors.md`
> - DataDoe API/Vibe code with Claude Code: `https://www.datadoe.com/hub/docs/datadoe-api/claude-code.md`
> - DataDoe API/Vibe code with Cursor: `https://www.datadoe.com/hub/docs/datadoe-api/cursor.md`
> - DataDoe API/Vibe code with Lovable: `https://www.datadoe.com/hub/docs/datadoe-api/lovable.md`
> - DataDoe API/Vibe code with Replit: `https://www.datadoe.com/hub/docs/datadoe-api/replit.md`
> - DataDoe API/Vibe code with v0: `https://www.datadoe.com/hub/docs/datadoe-api/v0.md`
> - DataDoe & BigQuery/How to connect to BigQuery: `https://www.datadoe.com/hub/docs/datadoe-bigquery/how-to-connect.md`
> - DataDoe & BigQuery/Using MCP Toolbox: `https://www.datadoe.com/hub/docs/datadoe-bigquery/mcp-toolbox.md`
> - DataDoe & BigQuery/Using Python Jupyter: `https://www.datadoe.com/hub/docs/datadoe-bigquery/jupyter.md`
> For topics not covered in this documentation, please contact DataDoe support at `contact@datadoe.com`.
> Do not assume anything. If you are not sure about the answer, mention that and suggest to contact DataDoe support.

# Connect Gemini to DataDoe

Connect the Gemini web app to DataDoe to ask about your Amazon sales, advertising, and inventory. You sign in to DataDoe during setup.

This guide covers custom connectors in the Gemini web app. For the terminal agent, see [Using Gemini CLI](/hub/docs/datadoe-mcp/gemini-cli).

## Before you start

- You have a DataDoe account with your Amazon accounts connected.
- You can add custom connectors in Gemini.
- Your role allows **MCP OAuth**. See [Manage roles and access](/hub/docs/basics/roles-and-permissions).

Gemini signs in to DataDoe as a public OAuth client. DataDoe does not issue a client secret.

If your Organization uses a different server address, copy it from [Integrations > MCP](https://app.datadoe.com/integrations/mcp) and use it everywhere this guide shows `https://mcp.datadoe.com/mcp/v1`. See [What is DataDoe MCP?](/hub/docs/datadoe-mcp/overview).

## Step 1: Add the connector

1. In Gemini, open Settings, then Connectors, and add a custom connector.
2. Enter DataDoe as the name.
3. Paste this server address.

```
https://mcp.datadoe.com/mcp/v1
```

4. Save the connector and start the connection.

Gemini registers itself with DataDoe. If it opens the DataDoe sign-in page, go to Step 3.

## Step 2: Enter a DataDoe client ID

If automatic registration fails, Gemini asks for a client ID and client secret. Register a client with DataDoe, then paste the `client_id` from the response.

1. In the custom connector form, open the additional settings and copy the redirect URI. It starts with `https://oauth-redirect.googleusercontent.com/`. It is not the DataDoe server address.
2. Register the client from a terminal. Replace `YOUR_GEMINI_REDIRECT_URI` with the redirect URI you copied.

```
curl -X POST https://auth.api.datadoe.com/auth/register \
  -H 'content-type: application/json' \
  -d '{"client_name":"Gemini","redirect_uris":["YOUR_GEMINI_REDIRECT_URI"],"token_endpoint_auth_method":"none","grant_types":["authorization_code","refresh_token"],"response_types":["code"],"scope":"mcp:read mcp:write offline_access"}'
```

3. Copy `client_id` from the response and paste it into Gemini as the client ID.
4. Leave the client secret empty.

Use this same registration address for `https://mcp.datadoe.com` and for a white-label address on `mcp.datadoe.com`.

If DataDoe rejects the redirect URI, check that you copied the value from Gemini and not the server address.

## Step 3: Approve access

1. Sign in with your DataDoe account for the Organization you want to use.
2. Review the access request and approve it.
3. Return to Gemini.

## Step 4: Check the connection

Start a new Gemini chat and send:

```
Use DataDoe to list my connected Amazon accounts.
```

If Gemini lists the accounts, the connection is ready. Then ask:

```
Use DataDoe to summarize my Amazon sales and advertising spend for the last 7 days.
```

Name the Amazon account or marketplace if you manage more than one.

Review tool requests before you approve them. Tools that perform Actions can change your Amazon data.

## If you need help

If you cannot add a custom connector, check that your Google account can use connectors in Gemini.

If sign-in fails, check the server address, allow pop-ups and redirects, and confirm the client ID is the value DataDoe returned. Leave the client secret empty.

If Gemini connects but returns no data, check your DataDoe Organization and Amazon connections, then ask Gemini to use DataDoe explicitly.

## Helpful resources

- [DataDoe MCP overview](/hub/docs/datadoe-mcp/overview)
- [Using Gemini CLI](/hub/docs/datadoe-mcp/gemini-cli)
- [Manage roles and access](/hub/docs/basics/roles-and-permissions)

---

## DataDoe MCP resources

Check the following resources for more information:

- MCP server URL: `https://mcp.datadoe.com/mcp/v1`
- [Interactive Data Scheme](/hub/data-scheme)
- Data Scheme JSON: https://api.datadoe.com/api/v1/spec/data-scheme
- Need help? Use the [contact form](https://forms.clickup.com/9015200219/f/8cnj2ev-38615/AOYF9I35QFOXWJQXIG?type=Form&source=hub-mcp-gemini-docs)
