AI Connectors
Connect Windsurf to Gravitask
Windsurf’s Cascade agent supports MCP servers over HTTP. Add Gravitask in the MCP settings (or straight into mcp_config.json) and Cascade can pull real project context into every session.
1. Create an API key
In the Gravitask app, open Settings > API & MCP and generate a key (create a free account first if you need one; API access needs Pro or higher). Grant the least access that does the job: pick the Read only scope for analysis and reporting, or restrict the key to tool groups such as Time tracking. The decision guide explains the options. Copy the key now; it is shown once.
2. Add the server to Windsurf
Open Settings > MCP > Add and paste the configuration below.
Settings > MCP > Add in the Windsurf editor.
Or edit ~/.codeium/windsurf/mcp_config.json directly.
{
"mcpServers": {
"gravitask": {
"type": "http",
"url": "https://app.gravitask.com/mcp",
"headers": {
"Authorization": "Bearer ${GRAVITASK_API_KEY}"
}
}
}
}3. Check it works
- In the MCP settings panel, gravitask should show as connected after a refresh.
- Ask Cascade: "List my Gravitask projects." A project list confirms the connection.
Prompts to try
- “Pull the details of Gravitask task GRV-91 and implement it.”
- “Create a Gravitask task to document this module, assigned to me.”
- “How much time has the team logged in Gravitask this month, by person?”
Troubleshooting
“Server listed but no tools”
Use the refresh button in the MCP panel after saving, and check the JSON has no trailing commas. If the environment variable is not picked up, paste the actual key value into the config.
“Permission denied on writes”
Your API key scope may be read-only, or your workspace admin has capped the MCP permission level. Check Settings > API & MCP in Gravitask.
Something else?
The full MCP setup guide covers the complete tool list, permission levels, and general troubleshooting. Using Claude or ChatGPT on the web instead? Those connect with one-click OAuth.
Next step
Ready to try it in Gravitask?
Create a workspace, then come back to this guide when you are ready to configure the workflow.
Keep reading
Related support guides
Helpful next steps from the Gravitask help centre.
AI integration
MCP Setup Guide
Connect Gravitask to AI tools through the Model Context Protocol.
Read guideAI integration
Connect Cursor to Gravitask
Add the Gravitask MCP server to Cursor so the agent can read, plan and update your work.
Read guideAI integration
Connect VS Code Copilot to Gravitask
Add the Gravitask MCP server to VS Code so Copilot agent mode can manage your tasks.
Read guide