MCP Integration

Connect Gravitask to AI Tools

Use the Model Context Protocol (MCP) to let AI assistants manage your tasks, projects, and time tracking directly in Gravitask.

What AI tools can do with Gravitask

List and browse projects
Create, update, and manage tasks
Search across your workspace
Add comments to tasks
Log time entries
View workspace members

Prerequisites

1A Gravitask account. Create one for free.
2An API key from Settings > API & MCP in the Gravitask app.

Quick Setup

This universal configuration works with most MCP-compatible AI tools. Copy it and replace YOUR_API_KEY with your actual API key.

{
  "mcpServers": {
    "gravitask": {
      "url": "https://app.gravitask.net/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Setup by AI Client

Expand the section for your AI tool to see specific setup instructions.

Available Tools

Gravitask exposes 15 tools through MCP, grouped by category.

Project Tools

Tool	Description	Permission
`list_projects` List all projects in the workspace	List all projects in the workspace	Read
`get_project` Get details of a specific project	Get details of a specific project	Read

Task Tools

Tool	Description	Permission
`get_task` Get task details (supports short IDs like GRV-42)	Get task details (supports short IDs like GRV-42)	Read
`create_task` Create a new task with full field support	Create a new task with full field support	Write
`update_task` Update an existing task	Update an existing task	Write
`delete_task` Delete a task	Delete a task	Write
`list_tasks` List tasks in a project with optional filters	List tasks in a project with optional filters	Read
`move_task` Move a task to a different section or project	Move a task to a different section or project	Write

Comment Tools

Tool	Description	Permission
`list_comments` List comments on a task	List comments on a task	Read
`add_comment` Add a comment to a task	Add a comment to a task	Write

Time Tracking

Tool	Description	Permission
`log_time` Log time against a task	Log time against a task	Write
`list_time_entries` List time entries for a task	List time entries for a task	Read

Search

Tool	Description	Permission
`search_tasks` Search tasks across the workspace	Search tasks across the workspace	Read

Workspace

Tool	Description	Permission
`get_workspace` Get workspace details and settings	Get workspace details and settings	Read
`list_members` List workspace members	List workspace members	Read

Troubleshooting

"Connection refused"

Check that your API key is valid. You can regenerate it from Settings > API & MCP in the Gravitask app.

"Permission denied"

Verify that MCP is enabled for your workspace in Settings > Integrations. Workspace admins control this setting.

"Tool not found"

Some tools may be disabled by your workspace admin. Check Settings > Integrations > MCP to see which tools are available.

"Timeout or slow response"

Large workspaces with many projects may take a moment to respond. If the issue persists, check the Gravitask status page.

← Back to Support