Coder MCP Server: Setup for Claude, Cursor and Other Apps

• Lists your workspaces

  Lists the workspaces of the signed-in user.

  Try: “List my Coder workspaces.”

  Read · coder_list_workspaces

• Shows one workspace

  Returns the details of a workspace by name or ID, with more data than the list.

  Try: “Show the status of my dev workspace.”

  Read · coder_get_workspace

• Creates a workspace from a template

  Creates a new workspace from a template. The tool description tells the assistant to confirm the template and settings with you first.

  Try: “Create a workspace from the Go template.”

  Write · coder_create_workspace

• Starts, stops or deletes a workspace

  Creates a build for an existing workspace to start, stop or delete it. A start can use a preset or parameter overrides.

  Try: “Stop my dev workspace.”

  Delete · coder_create_workspace_build

• Reads a workspace build log

  Returns the logs of a workspace build, to check whether it built.

  Try: “Why did my last workspace build fail?”

  Read · coder_get_workspace_build_logs

• Reads a workspace agent log

  Returns the logs of a workspace agent. More logs may appear after the call.

  Try: “Show the agent logs for my workspace.”

  Read · coder_get_workspace_agent_logs

• Lists templates

  Lists templates, and shows whether Coder Agents may create workspaces from each.

  Try: “What templates can I use?”

  Read · coder_list_templates

• Shows a template and its presets

  Returns a template's details, parameters and presets for its active version.

  Try: “What parameters does the Go template take?”

  Read · coder_get_template

• Lists template version parameters

  Returns the parameters of a template version, which are the workspace settings you choose when creating one.

  Try: “List the settings for this template version.”

  Read · coder_template_version_parameters

• Creates a template version

  Creates a template version, the step before creating or updating a template. Templates are Terraform that define a development environment.

  Try: “Create a new template version from these files.”

  Write · coder_create_template_version

• Uploads template files

  Creates and uploads a tar file from a map of file names to contents. It is used to build template versions.

  Try: “Upload these Terraform files for a new template.”

  Write · coder_upload_tar_file

• Creates a template

  Creates a template from a template version.

  Try: “Create a template from the version I just uploaded.”

  Write · coder_create_template

• Changes a template's active version

  Sets which version of a template new workspaces use.

  Try: “Make version 3 the active version of this template.”

  Write · coder_update_template_active_version

• Reads a template version log

  Returns the import logs of a template version.

  Try: “Did my template version import cleanly?”

  Read · coder_get_template_version_logs

• Deletes a template

  Deletes a template. The tool says this is irreversible.

  Try: “Delete the old-go template.”

  Delete · coder_delete_template

• Lists your organizations

  Lists the organizations you belong to. Being a member does not grant every permission.

  Try: “Which Coder organizations am I in?”

  Read · coder_list_organizations

• Shows who you are signed in as

  Returns the current user, like the whoami command.

  Try: “Who am I signed in as on Coder?”

  Read · coder_get_authenticated_user

• Lists a folder in a workspace

  Lists the contents of a directory inside a workspace.

  Try: “List the files in /home/coder/project.”

  Read · coder_workspace_ls

• Reads a file in a workspace

  Reads a file from a workspace.

  Try: “Read the README in my workspace.”

  Read · coder_workspace_read_file

• Writes a file in a workspace

  Writes a file in a workspace.

  Try: “Create a config.yaml in my workspace.”

  Write · coder_workspace_write_file

• Edits files in a workspace

  Makes edits to files inside a workspace.

  Try: “Rename the function in main.go.”

  Write · coder_workspace_edit_files

• Runs a command in a workspace

  Runs a shell command in a workspace. A call waits at most 5 minutes, and longer commands run in the background.

  Try: “Run the tests in my workspace.”

  Runs code · coder_workspace_execute

• Lists running processes

  Lists background processes started through the tools in a workspace.

  Try: “What background processes are running?”

  Read · coder_workspace_process_list

• Reads a process's output

  Reads the output of a background process started in a workspace.

  Try: “Show the output of the build I started.”

  Read · coder_workspace_process_output

• Sends a signal to a process

  Sends a signal to a process in a workspace, for example to stop it.

  Try: “Stop the dev server process.”

  Runs code · coder_workspace_process_signal

• Gets a URL for a workspace port

  Returns URLs that forward to a port in a workspace.

  Try: “Give me a link to port 3000 in my workspace.”

  Network · coder_workspace_port_forward

• Lists a workspace's apps

  Lists the URLs of Coder apps running in a workspace for one agent.

  Try: “What apps are running in my workspace?”

  Read · coder_workspace_list_apps

• Starts a Coder Agents chat

  Starts a Coder Agents chat, a server-side AI coding agent that works on its own from a prompt.

  Try: “Start an agent to fix the failing test in my repo.”

  Runs code · coder_create_chat

• Checks a Coder Agents chat

  Returns a chat's status, last error, last turn summary, workspace and attached files.

  Try: “What is the status of that agent chat?”

  Read · coder_get_chat

• Waits for a chat to finish

  Blocks until a chat stops generating, or until the wait times out.

  Try: “Wait for the agent chat to finish.”

  Read · coder_await_chat

• Lists Coder Agents chats

  Lists chats, optionally filtered by labels or a search query.

  Try: “List my recent agent chats.”

  Read · coder_list_chats

• Reads a chat transcript

  Returns the messages of a chat in order.

  Try: “Show me what the agent did in that chat.”

  Read · coder_get_chat_messages

• Sends a message to a chat

  Sends a message to an existing chat.

  Try: “Tell the agent to also update the docs.”

  Write · coder_send_chat_message

• Interrupts a running chat

  Stops a running chat. Progress so far is kept.

  Try: “Stop the running agent chat.”

  Write · coder_interrupt_chat

• Archives a chat

  Hides a chat from default lists. It can be unarchived in the web UI.

  Try: “Archive the finished agent chat.”

  Write · coder_archive_chat

• Gets a download link for a chat file

  Creates a short-lived download URL for a file attached to a chat.

  Try: “Give me a link to the file the agent produced.”

  Network · coder_download_chat_file

• Lists models for agent chats

  Lists the enabled models that Coder Agents chats can use.

  Try: “Which models can the agent chats use?”

  Read · coder_list_chat_model_configs

• Searches templates and workspaces

  A search tool for ChatGPT-style clients that searches templates, workspaces and files in workspaces.

  Try: “Search Coder for my Python workspace.”

  Read · search

• Fetches a template or workspace

  A fetch tool for ChatGPT-style clients that returns a template or a workspace.

  Try: “Fetch the Python template.”

  Read · fetch

Watch out for

• It can run commands inside your workspaces

  One tool runs shell commands, and others write files and signal processes in a workspace. Limit the tools with the local --allowed-tools flag if you only need reading. github.com

• It can delete workspaces and templates

  A build can delete a workspace, and one tool deletes a template. The tool description calls template deletion irreversible. github.com

• It acts with all your Coder permissions

  The server uses your signed-in account, so it can do what you can do. Use a limited account or token if you can. github.com

• A session token in a config file is a secret

  The manual remote setup puts a token in the client config. Keep that file private and delete the token when done. github.com

Security advisories