Quickstart

Connect an AI agent to Relaydeck. After that, the tasks of the agent show on your iPhone, iPad, and Apple Watch.

Get an API key#

  1. Open the Relaydeck app.
  2. Make an API key and give it a label, for example Claude Code. Use one key for each agent.
  3. Copy the key. It starts with mck_.

Install the plugin#

The plugin adds the Relaydeck MCP server to the agent. It also adds hooks that give the agent your tasks, answers, and messages from the app without a prompt. See Hooks.

Claude Code#

Type these commands in Claude Code.

Terminal
/plugin marketplace add Aayush9029/mcp-server
/plugin install relaydeck@relaydeck

Claude Code asks for the API key one time and keeps it in the Keychain.

Codex#

Terminal
export TASKS_API_KEY=YOUR_API_KEY
codex plugin marketplace add Aayush9029/mcp-server
codex plugin add relaydeck@relaydeck

Codex runs the hooks of a plugin only after you approve them. Type /hooks in Codex and trust the Relaydeck hooks.

Configure MCP manually#

Use this if your agent has no plugin, or if you run your own server. The transport is Streamable HTTP. Replace YOUR_API_KEY with the key from the app.

Claude Code#

Terminal
claude mcp add --transport http tasks https://relaydeck.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Codex#

Put this in ~/.codex/config.toml, then set TASKS_API_KEY in your shell.

TOML
[mcp_servers.tasks]
url = "https://relaydeck.onrender.com/mcp"
bearer_token_env_var = "TASKS_API_KEY"

Cursor and other clients#

JSON
{
  "mcpServers": {
    "tasks": {
      "url": "https://relaydeck.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

A client that cannot send headers can use the URL https://relaydeck.onrender.com/mcp?key=YOUR_API_KEY.

Try it#

Ask the agent: "Create a task for the database migration, keep its progress current, and ask me before you deploy."

The agent uses the tools in MCP. You see the task in the app, and you answer the question from the notification.

Then make a task for the agent in the app. An agent with the hooks gets the task and starts the work.

Use the REST API from a script#

An API key also works with the REST API.

Terminal
curl https://relaydeck.onrender.com/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Write the release notes", "priority": "high"}'

The response is the new Task. See REST API for all routes.

This page as Markdown