|Docs

Claude Code plugin

The Railway plugin for Claude Code packages the use-railway skill, Railway's hosted MCP server, supporting scripts, and hooks for managing Railway projects and deployments from your terminal.

Install the plugin from Anthropic's official marketplace, or install the version from the Railway source repository when you want to test repository changes directly.

Prerequisites

Before installing the plugin, set up these requirements:

The hosted MCP connection doesn't require the Railway CLI. Install and authenticate the Railway CLI when you want Claude Code to use local project context or CLI workflows.

Install from the official marketplace

Install the published Railway plugin from Anthropic's official Claude Code marketplace:

/plugin install railway@claude-plugins-official

After installation, ask Claude Code to deploy a service, check project status, manage an environment, or perform another task covered by the use-railway skill.

Install from the source repository

Add the Railway marketplace and install its plugin to use the version published directly from the source repository:

/plugin marketplace add railwayapp/railway-skills
/plugin install railway@railway-skills
/reload-plugins

You can also browse the marketplace through /plugin and select the Discover tab.

Update a source installation

Refresh the Railway marketplace to update an installation from the source repository:

/plugin marketplace update railway-skills

You can also enable auto-updates for the marketplace through /plugin under the Marketplaces tab.

What's included

The Claude Code plugin installs these components:

  • The use-railway skill provides workflows for project setup, deployments, troubleshooting, environment configuration, networking, observability, and more.
  • The hosted Railway MCP server connects Claude Code to Railway through OAuth without depending on local CLI state.
  • The auto-approve hook approves single Railway CLI and Railway API helper invocations that pass its shell safety checks.

Install only the agent skill

Install the agent skill without the Claude Code plugin when you don't need the hosted MCP configuration or hooks:

railway skills install

See Agent Skills for installation options and the full list of capabilities.

Use the Claude connector

Use the Railway connector for Claude when you want direct access to Railway's hosted MCP tools without the Claude Code plugin's terminal workflows, skill, or hooks.

View the source

The Railway Claude Code plugin is open-source in the Railway skills repository.