Connect your own agents to Undermind
Building or managing an integration? See our integration reference
ChatGPT — Web & Desktop One-click setup ↗
Undermind is available as a published ChatGPT app.
If the listing does not open, search for Undermind in ChatGPT’s Plugins
directory. Once connected, begin a new chat and type
@Undermind.
Claude — Web & Desktop One-click setup ↗
Open Undermind in Claude’s connector directory. If the button does not open it, paste https://claude.ai/directory/connectors/undermind into your
browser.
Connect, sign in to Undermind, and approve access. Then select Undermind from Claude’s Connectors menu in a chat.
Cursor Add to Cursor
This adds Undermind directly to Cursor. Or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"undermind": {
"type": "http",
"url": "https://mcp.undermind.ai/mcp",
"auth": {
"CLIENT_ID": "cursor"
}
}
}
}
Select Connect next to undermind in
Cursor Settings → MCP, or run
cursor-agent mcp login undermind in the CLI, and approve the browser
connection. If undermind does not appear, restart Cursor once.
Cursor completes sign-in on port 8787. If the browser shows a connection error after approval, close any other program using that port and reconnect. Cursor’s web-based Cloud Agents are not supported yet.
VS Code Add to VS Code
This adds Undermind to VS Code as an MCP server. Or add this to your user mcp.json, opened
with MCP: Open User Configuration from the Command Palette:
{
"servers": {
"undermind": {
"type": "http",
"url": "https://mcp.undermind.ai/mcp",
"oauth": {
"clientId": "vscode"
}
}
}
}
Trust the server when asked and approve the browser connection. If VS Code
asks for a client ID, use vscode and leave the secret blank. If it
does not prompt, run MCP: List Servers and start
undermind. One setup covers desktop and remote windows.
Codex
Run these commands in a terminal:
codex mcp add undermind --url https://mcp.undermind.ai/mcp --oauth-client-id codex
codex mcp login undermind Approve the browser connection, then restart Codex. One setup covers the Codex CLI, the IDE extension, and the ChatGPT desktop app’s Codex mode.
Claude Code
Run these commands in a terminal:
claude mcp add --transport http undermind https://mcp.undermind.ai/mcp
claude mcp login undermind Approve the connection in the browser window that opens. If Safari has trouble completing setup, try Chrome or Edge.
GitHub Copilot
For GitHub Copilot in VS Code, use the VS Code setup above. For the Copilot
CLI or desktop app, add this to ~/.copilot/mcp-config.json:
{
"mcpServers": {
"undermind": {
"type": "http",
"url": "https://mcp.undermind.ai/mcp",
"tools": ["*"],
"oauthClientId": "github-copilot"
}
}
}
Run /mcp auth undermind inside Copilot and approve the browser connection.
One configuration covers the Copilot CLI and desktop app.
Microsoft Copilot
This guide walks through how to set up Undermind MCP access in Microsoft 365 Copilot and Teams via a Copilot Studio agent.
1. Add an MCP server to your agent
Open your agent in Copilot Studio. Creating your first agent? See Microsoft’s getting started guide.
On the Build tab, click the + beside Tools, then choose Add → Model Context Protocol (MCP). See Microsoft’s MCP setup guide for GitHub Copilot.
Open your agent’s Tools page, select Add a tool, then Add new MCP. See Microsoft’s MCP setup guide for Standard.
2. Enter Undermind’s connection settings
-
Give the server a name that is unique in your Microsoft
environment, using 30 characters or fewer, such as Undermind Research. We suggest a description like “Search scientific literature,
run deep searches, read papers, and organize research in Undermind
workspaces.” Set the server URL to:
https://mcp.undermind.ai/mcp -
Choose OAuth 2.0 → Manual and fill in these values.
The token field may be labelled Token URL template.
- Client ID
-
m365-copilot - Client secret
-
m365-copilot - Authorization URL
-
https://api.undermind.ai/o/authorize/ - Token URL
-
https://api.undermind.ai/o/token/ - Refresh URL
-
https://api.undermind.ai/o/token/ - Scopes
-
mcp
Use
m365-copilotas the client secret. It is a public placeholder; you don’t need to generate a secret. Keep the final/on each URL. - Select Add Create. Studio displays a callback URL. You don’t need to copy or register it with Undermind; select Next.
3. Connect your Undermind account
- Select Not connected → Create new connection, then Create. Sign in to Undermind, approve access, and select Add to attach the server to your agent.
- Verify that the tool’s authentication is set to End user account. Open the newly added tool and expand Additional details. Verify that Credentials to use is set to End user credentials. This lets each person connect their own Undermind account. Save any changes.
4. Publish and check your connection
Publish your updated agent for use in Microsoft 365 Copilot and Teams. See Microsoft’s guides to publishing your agent and sharing it with colleagues. See Microsoft’s guide to opening and sharing your agent in Copilot and Teams.
Open the agent in Copilot or Teams and ask “List my Undermind workspaces.” Sign in to Undermind if prompted, and check that it returns your workspaces.
Opencode
Add this to ~/.config/opencode/opencode.json:
{
"mcp": {
"undermind": {
"type": "remote",
"url": "https://mcp.undermind.ai/mcp",
"oauth": {
"clientId": "opencode"
}
}
}
}
Run opencode mcp auth undermind in a terminal and approve the browser
connection.
Grok
Choose the plus button at the left of the chat box, then Connectors, Add Connector, and Custom. Name it Undermind and enter this server URL:
https://mcp.undermind.ai/mcp Then choose Add Connector. Grok asks for the connection details next — enter this client ID and leave the client secret blank:
grok Then choose Connect and approve the connection in the browser window.
Antigravity
Add this as mcp_config.json in
~/.gemini/antigravity/ for the app,
~/.gemini/config/ for the agy CLI, or
~/.gemini/antigravity-ide/ for the IDE. Each reads its own copy.
{
"mcpServers": {
"undermind": {
"serverUrl": "https://mcp.undermind.ai/mcp",
"oauth": {
"clientId": "antigravity"
}
}
}
}
Restart Antigravity, select Authenticate next to
undermind, and approve the browser connection. Copy the code
shown in the browser back into Antigravity.
Gemini
In the Gemini web app, open Settings → Personal Intelligence → Connected Apps and add a custom app with this link:
https://mcp.undermind.ai/mcp Expand Advanced features, enter this client ID, and leave the client secret blank:
gemini
Select Next and approve the connection. To send a prompt straight
to Undermind, type @ and choose it.
Perplexity
In Settings → Connectors on a paid plan, add a custom connector and choose streamable HTTP if asked. Enter this server URL:
https://mcp.undermind.ai/mcp Then enter this client ID, and leave the client secret blank:
perplexity Select Connect, approve the browser connection, and enable Undermind as a source in your threads.
Custom setup
Do you build or manage the software?
See our integration reference.
Just connecting an app that isn’t listed? Use .
Other apps
Your app may still work even if it isn’t listed. Find where it adds an MCP server and paste this address:
https://mcp.undermind.ai/mcp If it sends you to Undermind, follow the prompts to sign in and approve access. If it asks for a client ID or won’t connect, email support@undermind.ai with the app’s name and we’ll help you figure out the setup.
Doesn’t work with your app?
Thanks. We read every request.
Not connecting? Try upgrading your app to the latest version, or email support@undermind.ai
Research toolkit
MCP tool list
Enterprise integration
Works with the agent stack you already run
- Add the endpoint
Point your agent platform or MCP client at
https://mcp.undermind.ai/mcp - Connect the client
CIMD-capable clients identify themselves directly. Otherwise, send us your OAuth callback URL and we register the client for you.
- Use your existing identity
Each user authorizes access through their Undermind account. Your existing enterprise IdP and SSO can remain the sign-in path, where configured.
For setup and authorization details, see our integration reference.
Benchmark
More accuracy, less time
State-of-the-art literature search algorithms for complex research.
What changes once your agent has Undermind
Click through to Undermind: a UI built for the literature
Your agent automatically provides links for you to view the search results, reports, and PDFs in the Undermind UI.