home / mcp / godspeed mcp server
Connects to the Godspeed Task Management API to manage tasks and lists via MCP actions.
Configuration
View docs{
"mcpServers": {
"alinagy-godspeed-mcp": {
"command": "npx",
"args": [
"godspeed-mcp"
],
"env": {
"GODSPEED_TOKEN": "YOUR_TOKEN",
"GODSPEED_EMPTY_LIST_ID": "YOUR_LIST_ID"
}
}
}
}Godspeed MCP is a server connector that lets you manage tasks and task lists in the Godspeed Task Management API from an MCP client. It exposes common task operations through an MCP interface, so you can list, detail, create, update, delete, and organize tasks and lists efficiently from your workflow.
You run the Godspeed MCP server locally and connect to it from an MCP client. The server supports authenticating with a Godspeed API token and optionally using an empty-list template when you create new task lists. Once connected, you can perform core task operations such as listing tasks, getting details, creating tasks (individually or in bulk), updating tasks, deleting tasks, and marking tasks as complete or incomplete. You can also fetch and duplicate task lists, and create new lists using a template.
To start, provide your Godspeed API token and, if you want to automatically seed new lists with a template, specify an empty-list-id. You can supply the token via an environment variable or as a CLI argument when launching the MCP server. If you use an empty-list-id, it will be used as the template for new lists; otherwise you’ll provide the template ID when creating a new list.
Prerequisites: you need Node.js and npm installed on your system.
# Install the MCP server globally for easy access
npm install -g godspeed-mcp
# Quick start (no global install required):
# Run directly with npx without installing globally
npx godspeed-mcpOptional template configuration for new lists
Empty list template ID can be provided via environment variable or CLI flag. If omitted, you’ll supply the template ID when creating new lists.
{
"mcpServers": {
"godspeed-mcp": {
"command": "cmd /c",
"args": [
"godspeed-mcp",
"--token=your-godspeed-api-token",
"--empty-list-id=your-empty-list-id"
]
}
}
}Keep your Godspeed API token secret. If you expose the token, others could access and modify your Godspeed data through the MCP connection.
If you encounter authentication issues, verify that the token provided to the MCP server is correct and has the required permissions in Godspeed. For list creation templates, confirm that the empty-list-id corresponds to a valid template in your Godspeed account.
The Godspeed MCP server exposes core task and list management capabilities including listing tasks, retrieving task details, creating tasks (single or bulk), updating and deleting tasks, completing tasks, listing and creating lists, and duplicating existing lists.
Two configuration approaches are shown for running the MCP server locally. Use the approach that best fits your environment and security requirements.
# Quick start with a token via environment variable (Mac/Linux style):
export GODSPEED_TOKEN=your-godspeed-api-token
npx godspeed-mcp
# Quick start with explicit token flag:
npx godspeed-mcp --token=your-godspeed-api-tokenTwo explicit MCP start configurations are supported for this server: one for cross-platform use via npx and one for Windows-style execution via cmd.
Retrieve all tasks for a workspace or project, optionally filtering by list, status, or assignee.
Fetch detailed information for a specific task by its identifier.
Create a single new task or multiple tasks in a single request (up to 60 tasks in bulk).
Modify properties of an existing task, such as title, description, due date, or status.
Remove a task from the system.
Mark tasks as completed or revert them to an incomplete state.
Retrieve available task lists for your workspace.
Create new lists by duplicating a template list.
Create copies of existing task lists for rapid setup.