Connect Warplet to Grok

How to add your Warplet MCP URL as a custom connector to Grok, and how to fix the authorization and tool list problems that come up.

Warplet connects hosted AI clients to MCP servers running on your Mac. If you have not set it up yet, start with How to use Warplet. This guide covers grok.com. For Grok Bot, which has its own connector list, see Connect Warplet to Grok Bot.

Add the connector

  1. In Warplet, copy the URL for the server you want from Use these URLs to connect your favorite LLM. Each MCP server has its own URL; add one connector per URL.

    The Warplet app showing connection details and per-server URLs

  2. Open https://grok.com/connectors, click New Connector, and choose Custom.

  3. Fill in:

    • Name: the name of the app you're exposing, like DEVONthink or Obsidian
    • Server URL: your Warplet URL
  4. Click Add Connector.

  5. When Grok asks you to authorize, follow it to the Warplet authorization page, paste the bearer token from the Warplet app, and approve. The token works like a password for your tunnel, so paste it nowhere else.

    The Warplet authorization page asking for a bearer token

Troubleshooting

  • Adding the connector fails or the URL is rejected: open Warplet and check that it shows as connected, then add it again.
  • 401 error: the token was probably regenerated in Warplet after the connector was authorized. Reauthorize and paste the current token.
  • Grok never uses the connector: name it in your question, for example "use my DEVONthink connector to search for...".
  • A tool is missing or no longer exists: remove and re-add the connector to refetch the tool list.
  • Calls fail even though the connector is connected: start the local app the URL points at. Warplet cannot launch it for you.

Now connect an actual app

What the AI can do depends on which local MCP server the URL points at: