AI Connectors
Connect Cursor to Gravitask
Cursor speaks MCP natively, so Gravitask plugs in with a small JSON block and an API key. Once connected, Cursor’s agent can look up tasks, create work from code review findings, and log time without leaving the editor.
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 Cursor
Open Settings > MCP > Add Server and paste the configuration below.
Settings > MCP > Add Server in the Cursor editor.
{
"mcpServers": {
"gravitask": {
"type": "http",
"url": "https://app.gravitask.com/mcp",
"headers": {
"Authorization": "Bearer ${GRAVITASK_API_KEY}"
}
}
}
}3. Check it works
- In Settings > MCP the gravitask server should show a green status with its tool count.
- Open the agent chat and ask: "List my Gravitask projects." A project list confirms the key works.
Prompts to try
- “Find the Gravitask task GRV-118 and summarise what is left to do.”
- “Create a Gravitask task in the Web project for the bug we just found, priority HIGH.”
- “What did the team ship in Gravitask this week?”
Troubleshooting
“Server shows red or no tools in Settings > MCP”
Cursor does not expand shell variables in every version. Replace ${GRAVITASK_API_KEY} in the pasted JSON with the actual key value, save, then toggle the server off and on.
“Tools appear but calls fail with permission errors”
The key may be read-only or restricted to tool groups. Create a key with the scope the agent needs from 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 VS Code Copilot to Gravitask
Add the Gravitask MCP server to VS Code so Copilot agent mode can manage your tasks.
Read guideAI integration
Connect Windsurf to Gravitask
Add the Gravitask MCP server to Windsurf so Cascade can work with your projects and tasks.
Read guide