Use DEVONthink with any AI client

How to expose DEVONthink databases to hosted AI clients through Warplet, using DEVONthink's built-in MCP server.

Warplet is a macOS app that connects hosted AI clients like ChatGPT, Claude, Perplexity, and Grok to MCP servers running locally on your Mac. No port forwarding or cloud hosting is required. It opens a secure tunnel and gives you one URL per local MCP server to paste into any AI client.

DEVONthink's built-in MCP server lets an AI client search your databases, read documents and metadata, and organize files.

1. Enable the MCP server in DEVONthink

In DEVONthink, open Settings → AI (or press ⌘, and click AI in the toolbar), then select the MCP tab.

You will see DEVONthink's built-in MCP server configuration:

  • Port: defaults to 8420.
  • URL: shows http://localhost:8420.
  • Accept Connections: keep this set to From this Mac only. Warplet runs on the same Mac.
  • Bearer Token: DEVONthink generates a secure bearer token (prefixed with de_). Click Create if you need to generate a new one. Copy this token for the next step.
  • Privacy (optional): check Redact sensitive content if you want DEVONthink to automatically mask credit card numbers, email addresses, phone numbers, IBANs, and API keys when AI clients read documents from your databases.

DEVONthink Settings showing the AI > MCP tab with the local URL, Port, and Bearer Token

2. Add DEVONthink as a server in Warplet

Open Warplet and click Manage Servers, then the + button (or click Edit if DEVONthink is already listed). Fill in:

  • Name: DEVONthink
  • ID (URL prefix): devonthink
  • URL: http://localhost:8420
  • Authorization: check this box and paste the Bearer Token you copied from DEVONthink's settings into Bearer Token

Click Test Connection to confirm Warplet can reach DEVONthink. Warplet shows how many tools DEVONthink offers. Then click Add (or Save).

The Warplet Add Server form filled in with the DEVONthink MCP URL, Bearer Token, and successful test connection

3. Copy your DEVONthink URL and connect an AI client

Back in the main Warplet window, your DEVONthink entry now appears under Use these URLs to connect your favorite LLM. Copy that URL.

The Warplet connected panel listing per-server URLs, including DEVONthink

Add it as a custom connector in your AI client of choice, using the same steps as any other Warplet server:

When the client asks you to authorize, paste the Warplet bearer token. Do not use DEVONthink's internal token here; that token stays inside Warplet's server configuration from step 2.

Things to know

  • Two separate tokens. DEVONthink's bearer token lets Warplet reach DEVONthink. The Warplet bearer token lets the AI client reach Warplet.
  • DEVONthink has to be running. If it is closed, Warplet has nothing to forward to. Check Launch at login in DEVONthink's MCP settings to start it automatically.