Skip to main content

Prerequisites

  • Raycast installed (requires Raycast Pro subscription to use AI features)
  • Linkly AI CLI installed (Raycast only supports Stdio transport, so the CLI is required)
  • Linkly AI Desktop running with the MCP service active

Configuration Steps

1

Open the MCP extension

In Raycast, search for Install Server, or go to Raycast Store to install the MCP extension (if not already installed).
2

Add Linkly AI

Run the Install Server command and fill in: - Name: linkly-ai - Type: stdio - Command: linkly - Arguments: mcp --client raycast
3

Restart Raycast

After saving, fully quit and restart Raycast to apply the configuration.
Raycast currently only supports Stdio transport and does not support HTTP URL method. Therefore you must install Linkly AI CLI first, which acts as a bridge to communicate with the desktop app.

Getting Started

Once configured, type @linkly-ai in Raycast AI Chat to invoke the tool, or ask questions directly and Raycast will automatically call Linkly AI’s tools. For example:
  • “Search my documents for content about product design”
  • “@linkly-ai read my project readme”

FAQ

Raycast uses an independent PATH environment and may not find linkly. We recommend entering the CLI’s absolute path directly in Command: if you installed it with the install script or from the desktop app, the path is /Users/<your-username>/.linkly/bin/linkly; if you installed it another way, such as Homebrew, run which linkly in the terminal to find it. After the change, fully restart Raycast for it to take effect.
Confirm that Linkly AI Desktop is running and the MCP service is active. Raycast connects to the CLI on every call, so the desktop app must be running.