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

  1. 1A Gravitask account. Create one for free.
  2. 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 27 tools through MCP, grouped by category.

Wiki Tools

ToolPermission
list_wiki_pages

List wiki pages in the workspace

Read
search_wiki_pages

Search wiki pages with permission filtering

Read
get_wiki_page

Read a wiki page by UUID

Read
create_wiki_page

Create a wiki page in the workspace

Write
update_wiki_page

Update a wiki page title or body

Write
verify_wiki_page

Mark a wiki page as verified

Write

Project Tools

ToolPermission
list_projects

List all projects in the workspace

Read
get_project

Get details of a specific project

Read

Task Tools

ToolPermission
get_task

Get task details (supports short IDs like GRA-81)

Read
list_tasks

List tasks in a project with optional filters

Read
create_task

Create a new task with full field support

Write
update_task

Update an existing task

Write
complete_task

Close a task

Write
delete_task

Delete a task

Write
move_task

Move a task to a different section or project

Write

Comment Tools

ToolPermission
list_comments

List comments on a task

Read
add_comment

Add a comment to a task

Write

Time Tracking

ToolPermission
log_time

Log time against a task

Write
list_time_entries

List time entries for a task

Read

Search

ToolPermission
search

Search tasks, projects, and comments across the workspace

Read

Workspace

ToolPermission
get_workspace

Get workspace details and settings

Read
list_members

List workspace members

Read

Tags

ToolPermission
list_tags

List all tags in a project

Read
create_tag

Create a new tag in a project

Write
add_tag_to_task

Add a tag to a task

Write
remove_tag_from_task

Remove a tag from a task

Write

Planning

ToolPermission
get_critical_path

Compute the longest dependency chain for a project

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.

"Codex does not show Gravitask tools"

Check that the URL is https://app.gravitask.net/mcp and that bearer_token_env_var contains an environment variable name such as GRAVITASK_API_KEY. The token value itself belongs in that environment variable.

"Timeout or slow response"

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

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.

Start freeExplore related features

Keep reading

Related support guides

Helpful next steps from the Gravitask help centre.

Developer API

REST API Documentation

Build integrations with projects, tasks, comments, time entries, and webhooks.

Read guide

Automations

Automation Variables

Use task, project, assignee, and workspace variables in automation messages.

Read guide

Task scheduling

Recurring Tasks

Create repeating tasks for daily, weekly, monthly, and custom schedules.

Read guide
← Back to Support