MCP server

Before you connect

1. 1

   Create your library. Sign in to Dioveo with Google and let the attachment index finish its first scan.

2. 2

   Add the server. Find your client below and use its exact command or configuration format.

3. 3

   Approve access. Dioveo shows every permission, enabled by default. Turn off anything you do not want to share before connecting.

Set up your client

Each client asks for the server in its own way. Use the entry that matches yours; the resulting connection is the same.

Claude

Web, desktop and mobile

1. 1In Claude on the web, open Customize, then Connectors, and click the plus button.
2. 2Choose “Add custom connector”, name it Dioveo, paste the server URL, and click Add.
3. 3Click Connect next to Dioveo and approve the permissions on the Dioveo screen.

https://server.dioveo.com/mcp

Connectors added on the web are also available in Claude desktop and mobile. Team and Enterprise workspaces may require an owner to add the connector first.

Claude Code

One command

1. 1Paste the command shown here into a terminal.
2. 2Your browser opens Dioveo. Sign in and approve the requested permissions.
3. 3Run “claude mcp get dioveo” or open /mcp inside Claude Code to verify the connection.

$ claude mcp add --transport http dioveo https://server.dioveo.com/mcp && claude mcp login dioveo

The command stores Dioveo for the current project and immediately starts OAuth. Add “--scope user” before the URL if you want it available in every project.

ChatGPT

Developer mode

1. 1Open Settings, choose Security and login, and turn on Developer mode.
2. 2Open Plugins, click the plus button, and create a connection named Dioveo using the server URL.
3. 3Review the discovered tools, then add Dioveo from the tools menu in a new conversation.

https://server.dioveo.com/mcp

Developer mode and plugin availability can depend on your account and workspace policy.

Codex

CLI, desktop and IDE

1. 1Paste the command shown here into a terminal.
2. 2Complete the Dioveo sign-in and consent flow in your browser.
3. 3Run “codex mcp list” or type /mcp in Codex to verify the connection.

$ codex mcp add dioveo --url https://server.dioveo.com/mcp && codex mcp login dioveo

The Codex CLI, desktop app, and IDE extension share the same MCP configuration.

Cursor

One-click install

1. 1Click “Add to Cursor” and confirm the new MCP server.
2. 2Cursor opens Dioveo to sign in; approve the permissions it requests.
3. 3Ask in Agent chat, for example “find the signed NDA from Acme”.

{  "mcpServers": {    "dioveo": {      "url": "https://server.dioveo.com/mcp"    }  }}

The one-click link writes the same remote-server entry shown here.

From a search to a complete document collection

Ask your assistant to save a collection of matching attachments, extract fields across it, compare versions, identify exact duplicates, and export CSV or Excel with source evidence. Runs survive a disconnected conversation and keep individual failures visible. Compatible clients also show an interactive evidence viewer.

Start with:

Collect this quarter's Acme invoices and credit notes. Extract invoice number, date, currency and total. Show duplicates and unresolved documents, total verified values by currency, and export the result.

Search covers the indexed attachment metadata and retained extracted text. Your assistant can report index freshness, unread documents, and incomplete extraction. Sensitive values need a separate approval in Dioveo for the exact read request.

Permissions

Dioveo shows these on one consent screen when a client first connects. Nothing is granted until you approve it.

Search attachments

Find indexed files and metadata from your Gmail history.

Read documents and extract fields

Request text or structured fields from selected documents, with source references. Recognized sensitive values are redacted by default.

Create workflow drafts

Prepare an automation for review. The assistant cannot activate or run it.

Download selected originals

A separate permission for ZIP downloads. Original files contain their unredacted contents.

Upload attachments to cloud storage

Save selected original attachments to your connected Google Drive, Dropbox or OneDrive. Uses your file-transfer allowance and includes unredacted contents. No automation is activated.

An assistant cannot send email, delete messages, or change your Gmail. Revoke it at any time from Dioveo's Connections page.

Other MCP clients

Any client that supports remote Streamable HTTP servers and standard MCP OAuth works. Add the server URL with no Authorization header; the client discovers OAuth and opens the Dioveo consent screen.

Clients limited to local stdio servers, legacy SSE, or static bearer tokens are not directly compatible.

Troubleshooting