Wordle MCP (Python)
[!NOTE] To check out the Go version of this MCP Server (lighter, faster), click here
A MCP Server for fetching the Wordle solutions via the Wordle API.
[!IMPORTANT] 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)
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-python: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-python: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-python",
"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