Godspeed MCP

A Model Context Protocol connector for the Godspeed Task Management API.

Installation

You can use this tool without installation via npx:

npx godspeed-mcp

Or install it globally:

npm install -g godspeed-mcp

Configuration

Authentication Token

The Godspeed API token can be provided in two ways:

1. Environment variable: `GODSPEED_TOKEN`

2. Command line argument: `--token=YOUR_TOKEN` or `-t YOUR_TOKEN`

Empty List ID (Optional)

For creating new task lists, you can configure an empty list ID to use as a template:

1. Environment variable: `GODSPEED_EMPTY_LIST_ID`

2. Command line argument: `--empty-list-id=YOUR_LIST_ID` or `-e YOUR_LIST_ID`

If not provided, you'll need to specify the empty list ID when creating new lists.

Cursor MCP Configuration

For Windows, create a file at `%USERPROFILE%\.cursor\mcp.json` with the following structure:

{
  "mcpServers": {
    "godspeed-mcp": {
      "command": "cmd /c",
      "args": [
        "godspeed-mcp",
        "--token=your-godspeed-api-token",
        "--empty-list-id=your-empty-list-id" // Optional
      ]
    }
  }
}

For Mac/Linux, create a file at `~/.cursor/mcp.json` with this structure:

{
  "mcpServers": {
    "godspeed-mcp": {
      "command": "npx",
      "args": ["godspeed-mcp"],
      "env": {
        "GODSPEED_TOKEN": "your-godspeed-api-token",
        "GODSPEED_EMPTY_LIST_ID": "your-empty-list-id" // Optional
      }
    }
  }
}

Features

This MCP connector provides the following task management tools:

• List all tasks
• Get task details
• Create new tasks (single or bulk up to 60 tasks)
• Update existing tasks
• Delete tasks
• Complete/uncomplete tasks
• Get task lists
• Create new task lists (by duplicating a template)
• Duplicate existing lists

License

MIT