AI Connectors
Connect VS Code (GitHub Copilot) to Gravitask
Copilot’s agent mode in VS Code picks up MCP servers from .vscode/mcp.json. Add Gravitask once per workspace (or in your user settings for everywhere) and Copilot can plan and update your real work items.
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 VS Code (GitHub Copilot)
Create or update the .vscode/mcp.json file in your workspace root.
.vscode/mcp.json in your project root.
{
"servers": {
"gravitask": {
"type": "http",
"url": "https://app.gravitask.com/mcp",
"headers": {
"Authorization": "Bearer ${GRAVITASK_API_KEY}"
}
}
}
}3. Check it works
- Run the "MCP: List Servers" command from the command palette; gravitask should be listed and running.
- In Copilot Chat (agent mode), ask: "List my Gravitask projects." VS Code may prompt you to trust and start the server first.
Prompts to try
- “Create Gravitask tasks for the review comments on this pull request.”
- “What Gravitask tasks are assigned to me and due this week?”
- “Mark GRV-77 as done in Gravitask and add a comment linking this commit.”
Troubleshooting
“Server never starts or shows an error in MCP: List Servers”
VS Code substitutes ${GRAVITASK_API_KEY} from its own environment. Launch VS Code from a shell where the variable is exported, or replace the placeholder with the actual key in .vscode/mcp.json (and keep that file out of version control).
“Copilot does not use the tools”
MCP tools are only available in agent mode. Switch the chat mode to Agent and check Gravitask tools are enabled in the tools picker.
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 guideDeveloper API
REST API Documentation
Build integrations with projects, tasks, comments, time entries, and webhooks.
Read guide