mcpField
P
projects

projects

github.com/railwayappCloud & DevOps339851 installsUpdated 2w ago
Repository

About projects

A skill for managing Railway projects, including listing projects and workspaces, switching projects, and updating settings. It can change names, visibility, and PR deployment options.

Key features

  1. 01List projects and workspaces
  2. 02Switch the current project
  3. 03Edit project name and description
  4. 04Set visibility and PR deployments

Use cases

  1. 01Review projects available to an account
  2. 02Link a directory to another project
  3. 03Change project visibility or PR deployments

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/railwayapp/railway-skills --skill projects

After installing, type/projectsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
environment-config.md
monorepo.md
railpack.md
variables.md
scripts/
railway-api.sh

Details

From the project README

Project Management

List, switch, and configure Railway projects.

When to Use

  • User asks "show me all my projects" or "what projects do I have"
  • User asks about projects across workspaces
  • User asks "what workspaces do I have"
  • User wants to switch to a different project
  • User asks to rename a project
  • User wants to enable/disable PR deploys
  • User wants to make a project public or private
  • User asks about project settings

List Projects

The railway list --json output can be very large. Run in a subagent and return only essential fields:

  • Project: id, name
  • Workspace: id, name
  • Services: name (optional, if user needs service context)
railway list --json

Extract and return a simplified summary, not the full JSON.

List Workspaces

railway whoami --json

Returns user info including all workspaces the user belongs to.

Switch Project

Link a different project to the current directory:

railway link -p <project-id-or-name>

Or interactively:

railway link

After switching, use status skill to see project details.

Update Project

Modify project settings via GraphQL API.

Get Project ID
railway status --json

Extract project.id from the response.

Update Mutation
bash <<'SCRIPT'
scripts/railway-api.sh \
  'mutation updateProject($id: String!, $input: ProjectUpdateInput!) {
    projectUpdate(id: $id, input: $input) { name prDeploys isPublic botPrEnvironments }
  }' \
  '{"id": "PROJECT_ID", "input": {"name": "new-name"}}'
SCRIPT
ProjectUpdateInput Fields
FieldTypeDescription
nameStringProject name
descriptionStringProject description
isPublicBooleanMake project public/private
prDeploysBooleanEnable/disable PR deploys
botPrEnvironmentsBooleanEnable Dependabot/Renovate PR environments
Examples

Rename project:

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'

Enable PR deploys:

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'

Make project public:

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'

Multiple fields:

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'

Composability

  • View project details: Use status skill
  • Create new project: Use new skill
  • Manage environments: Use environment skill

Error Handling

Not Authenticated
Not authenticated. Run `railway login` first.
No Projects
No projects found. Create one with `railway init`.
Permission Denied
You don't have permission to modify this project. Check your Railway role.
Project Not Found
Project "foo" not found. Run `railway list` to see available projects.

Comments

Markdown supported