How to add Railway MCP Server to Claude Desktop

Community server to manage Railway.app projects, services, and deployments via your agent. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 500★ · stdio · apikey

Claude Desktop config for Railway MCP Server

npx -y @jasontanswe/railway-mcp

{
  "mcpServers": {
    "railway-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jasontanswe/railway-mcp"
      ],
      "env": {
        "RAILWAY_API_TOKEN": "<your-railway-api-token>"
      }
    }
  }
}

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Railway MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Railway MCP Server's tools appear under the 🔌 tools menu.

Before you start

Node.js 18+ (required for the built-in fetch API)
An active Railway account
A Railway API token, created at railway.app/account/tokens (an account- or team-scoped token)
An MCP-capable client such as Claude Desktop, Cursor, Cline, or Windsurf

What Railway MCP Server can do in Claude Desktop

configure

Set or update the Railway API token for the session.

project-list

List all projects on your Railway account.

project-info

Get details and environments for a specific project.

project-create

Create a new Railway project.

project-delete

Delete a project.

service-list

List the services within a project.

service-create-from-repo

Deploy a new service from a GitHub repository.

service-create-from-image

Deploy a new service from a Docker image.

Security

The Railway API token grants control over your projects and deployments, so generate a dedicated token and revoke it if exposed. This is an unofficial community project, so review the source before granting production access.

Railway MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Railway MCP Server config there under the "mcpServers" key and restart the client.

Is Railway MCP Server safe to use with Claude Desktop?

Where do I get the Railway API token?

Create one at railway.app/account/tokens. You can use an account token or a team/project-scoped token; the server reads it from the RAILWAY_API_TOKEN environment variable (or via the configure tool).

Is this an official Railway server?

No. It is a community project (npm package @jasontanswe/railway-mcp) and is not maintained by Railway itself, though it uses Railway's public API.

Which clients does it work with?

It is documented and tested with Claude Desktop and Cursor, with Cline and Windsurf listed as supported but less battle-tested. Any stdio MCP client should work.

View repo Full Railway MCP Server page