Replit MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with Replit workspaces directly, without needing an agentic browser or constant user intervention.

Features

User Management: Get current user, lookup users by ID or username
Repl Management: List, create, fork, delete, and get detailed repl information
File Operations: Read, write, create, delete files and directories
Environment Variables: Manage secrets and environment variables
Deployments: Get deployment info and publish repls
Search: Search for content within files

Installation

From Smithery

smithery install replit-workspace --client claude

Manual Installation

Clone this repository
Install dependencies: npm install
Build: npm run build
Run: npm start

Configuration

The server requires a REPLIT_TOKEN environment variable containing your Replit connect.sid cookie token.

Getting Your Token

Log into Replit in your browser
Open Developer Tools (F12)
Go to Application > Cookies > replit.com
Copy the value of connect.sid

Claude Desktop Configuration

Add to your Claude Desktop config file:

{
  "mcpServers": {
    "replit": {
      "command": "node",
      "args": ["/path/to/replit-mcp-server/dist/index.js"],
      "env": {
        "REPLIT_TOKEN": "your-connect-sid-token"
      }
    }
  }
}

Available Tools (24 Total)

User Operations

Tool	Description
`get_current_user`	Get info about the authenticated user
`get_user_by_id`	Get user info by numeric ID
`get_user_by_username`	Get user info by username

Repl Management

Tool	Description
`list_repls`	List repls owned by the user
`get_repl_by_url`	Get repl info by URL
`get_repl_details`	Get detailed repl info (comments, multiplayers, tags, stats)
`set_active_repl`	Set the active repl for subsequent operations
`create_repl`	Create a new repl
`fork_repl`	Fork an existing repl
`delete_repl`	Delete a repl (requires confirmation)
`run_repl`	Start a repl
`stop_repl`	Stop a running repl

File Operations

Tool	Description
`read_file`	Read file contents
`write_file`	Write content to a file
`list_files`	List files in a directory
`create_file`	Create a new file
`delete_file`	Delete a file
`create_directory`	Create a new directory
`search_files`	Search for content in files

Environment Variables

Tool	Description
`get_secrets`	List all environment variables for a repl
`set_secret`	Set an environment variable
`delete_secret`	Delete an environment variable

Deployments

Tool	Description
`get_deployment`	Get deployment info for a repl
`create_deployment`	Deploy/publish a repl

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build
npm run build

# Start production server
npm start

Deployment to Smithery

Ensure you have a Dockerfile and smithery.json in your repo
Push to GitHub
Connect your repository via Smithery dashboard
Deploy

API Coverage

This MCP server provides comprehensive coverage of Replit's GraphQL API including:

User queries and lookups
Repl CRUD operations
File system operations
Environment variable management
Deployment management
Search functionality

License

MIT