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
Open the MCP extension
In Raycast, search for Install Server, or go to Raycast Store to
install the MCP extension (if not already installed).
Add Linkly AI
Run the Install Server command and fill in: - Name:
linkly-ai -
Type: stdio - Command: linkly - Arguments: mcpRaycast 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
Error: cannot find the linkly command
Error: cannot find the linkly command
Raycast uses an independent PATH environment. Make sure
linkly is
installed in a standard path (such as /usr/local/bin or
/opt/homebrew/bin). Run which linkly in the terminal to confirm the
path, and make sure that path is in Raycast’s PATH. After modifying PATH,
you need to fully restart Raycast for changes to take effect.Tool list is empty
Tool list is empty
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.

