Wordle MCP

A MCP Server for fetching the Wordle solutions via the Wordle API.

Note

Wordle solutions are only available from 2021-05-19, to 23 days in the future.
Any other attempts at calling other dates will return an error from the API

Index

• Get Started
  • Using Docker (recommended)
  • Installing via uvx
• Examples on Claude Desktop
• Contributing

---

Get Started

Using Docker (recommended)

Ensure that you have Docker installed.
Add this to your MCP Server configuration:

{
  "mcpServers": {
    "Wordle MCP (Python)": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "ghcr.io/cr2007/mcp-wordle:latest"
      ]
    }
  }
}

Important

If you get an error on Claude Desktop for the first time, just make sure to pull the image before running.
docker pull ghcr.io/cr2007/mcp-wordle:latest

Installing via uvx

The quickest and easiest method to get started. Make sure to install uv before adding this in your configuration.
Add this to your MCP server configuration:

{
  "mcpServers": {
    "Wordle MCP (Python)":{
      "command": "uvx",
        "args": [
          "--from",
          "git+https://github.com/cr2007/mcp-wordle",
          "mcp-wordle"
        ]
      }
  }
}

Examples on Claude Desktop

Contributing

Contributions are welcome! You may fork the repo, create your changes in a branch, and then create a Pull Request