home / mcp / sleep mcp server

Sleep MCP Server

Tool that allows you to wait a certain time to continue the execution of an agent.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "agentsworkingtogether-mcp-sleep": {
      "command": "uvx",
      "args": [
        "mcp-sleep"
      ],
      "env": {
        "MCP_SLEEP_TIMEOUT": "<MCP_SLEEP_TIMEOUT>"
      }
    }
  }
}

Sleep MCP Server provides a timed pause in your agent workflows. By introducing configurable delays, you can ensure actions occur in the exact order you need, helping manage sequences and pacing in automated tasks.

How to use

You run the Sleep MCP Server as a local or SSE-enabled service and connect it to your MCP client. When you trigger the sleep tool, you specify a number of seconds to wait. The server responds with a confirmation after the pause, allowing your automation to resume exactly when the delay completes.

How to install

Prerequisites you need before installing Sleep MCP Server are minimal: you should have Claude Desktop installed and the MCP runtime tools available. A lightweight runtime called uv/uvx is used to run the MCP server locally or via container execution.

Step 1 — Install the Sleep MCP Server for Claude Desktop via Smithery:

npx @smithery/cli install @AgentsWorkingTogether/mcp-sleep --client claude

Step 2 — Or install the Sleep MCP server using mcp-get:

npx @michaellatman/mcp-get@latest install mcp-sleep

Additional configuration and usage notes

You configure Claude Desktop to load the Sleep MCP server as a local MCP endpoint. Create or edit the following configuration JSON to register the server.

{
  "mcpServers": {
    "mcp-sleep": {
      "command": "uvx",
      "args": [
        "mcp-sleep"
      ],
    }
  }
}

Docker usage example

If you prefer running Sleep MCP Server via Docker, you can configure Claude Desktop to start the server with Docker and expose the timeout environment variable.

{
  "mcpServers": {
    "mcp-sleep": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MCP_SLEEP_TIMEOUT",
        "mcp/sleep"
      ],
      "env": {
        "MCP_SLEEP_TIMEOUT": "<MCP_SLEEP_TIMEOUT>"
      }
    }
  }
}

Available tools

sleep

Pauses execution for a specified duration in seconds and returns a message confirming the wait; enforces a maximum timeout if configured.