MCP Connector

Connect ProGantt Flow to Claude or any MCP client, and let your AI assistant read and update your Gantt charts — tasks, dependencies, milestones, people and tags.

Last updated: 3 November 2026

1. What it does

ProGantt Flow is a Gantt chart and project planning app. Its MCP (Model Context Protocol) server lets an AI assistant work on your ProGantt projects on your behalf: draft a full plan with dependencies, reschedule tasks, assign people, track progress, spot who is overloaded, and answer questions about what blocks what.

Everything the assistant does is a normal edit to your project. Changes appear in the ProGantt web app immediately, for you and for everyone you share the project with.

2. Before you start

Plan Projects Active access tokens
Free Unlimited 2
Pro Unlimited Unlimited

Connecting Claude, ChatGPT or Codex through OAuth doesn't use an access token.

3. Connect Claude (web, desktop and mobile)

  1. In Claude, open Settings › Connectors and choose Add custom connector.
  2. Paste the server URL, including the /mcp path: 
    https://mcp.progantt.com/mcp
  3. Click Connect. A ProGantt page opens: sign in with the Google or Microsoft account you use for ProGantt and click Allow.
  4. Back in Claude, enable the ProGantt connector in a conversation and ask something like “List my ProGantt projects”.

On Team and Enterprise plans, an organization Owner may need to add the connector first before members can connect it. Once connected on claude.ai, the connector is also available in Claude Desktop and mobile.

4. Connect ChatGPT

ChatGPT adds remote MCP servers as plugins. You sign in with your ProGantt account, so there is no token to copy.

  1. In ChatGPT, open Plugins (chatgpt.com/plugins), click + and choose Add custom MCP server.
  2. Enter a name (for example ProGantt) and a short description.
  3. Under Connection, paste the server URL, including the /mcp path: 
    https://mcp.progantt.com/mcp
  4. Choose OAuth as the authentication, read the warning and click I understand and want to continue, then Create as a plugin.
  5. Install the plugin. A ProGantt page opens: sign in with the Google or Microsoft account you use for ProGantt and click Allow.
  6. In a new chat, type @, pick ProGantt and ask something like “List my ProGantt projects”.

Whether you can add custom MCP servers depends on your ChatGPT plan and, on Business and Enterprise, on the permissions your workspace admin has enabled.

5. Connect Codex

The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share one MCP configuration, so you only add ProGantt once. Codex signs in with OAuth, like Claude and ChatGPT.

ChatGPT desktop app or IDE extension

  1. Open Settings › MCP servers and click Add server.
  2. Name it progantt, choose Streamable HTTP and enter https://mcp.progantt.com/mcp.
  3. Leave the bearer token and header fields empty. Save and restart.
  4. Click Authenticate next to the server and sign in with your ProGantt account.

Avoid the stdio option: it is for servers that run on your own computer, and ProGantt is a remote server.

Codex CLI (~/.codex/config.toml)

[mcp_servers.progantt]
url = "https://mcp.progantt.com/mcp"

Then sign in once:

codex mcp login progantt

Type /mcp in Codex to check that the server is active.

Using an access token instead

If you'd rather not use OAuth, generate a token in Connect AI and pass it through an environment variable. Codex's bearer_token_env_var (the bearer token field in the app) expects the name of the variable, not the token itself:

[mcp_servers.progantt]
url = "https://mcp.progantt.com/mcp"
bearer_token_env_var = "PROGANTT_MCP_TOKEN"
export PROGANTT_MCP_TOKEN="<your-pgmcp-token>"

The variable must be set in the environment Codex starts from. Desktop apps opened from the Dock don't read your shell profile.

6. Connect Claude Code, Cursor, VS Code and other clients

Clients that authenticate with a header use a personal access token instead of OAuth.

  1. In ProGantt, click Connect AI on the dashboard, pick your client and generate a token. The token starts with pgmcp_ and is shown only once — copy it straight away.
  2. Add the server to your client with the token as a bearer header.

Claude Code

claude mcp add --transport http progantt https://mcp.progantt.com/mcp \
  --header "Authorization: Bearer <your-pgmcp-token>"

Cursor (~/.cursor/mcp.json or .cursor/mcp.json)

{
  "mcpServers": {
    "progantt": {
      "url": "https://mcp.progantt.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-pgmcp-token>"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "progantt": {
      "type": "http",
      "url": "https://mcp.progantt.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-pgmcp-token>"
      }
    }
  }
}

Older clients (LM Studio and others)

Clients that only speak the legacy HTTP+SSE transport can use https://mcp.progantt.com/sse with the same bearer header.

7. What the assistant can do

The connector exposes 27 tools. Each one is annotated as read-only or as a write, so Claude can ask for your confirmation before changing anything, according to your settings.

Read (never change anything)

list_projects Projects you own or that are shared with you.
get_project Full content of one project: tasks, milestones, people, tags, collaborators.
list_tasks, list_tasks_by_filter All tasks, or those matching a title, tag, person, date window or progress range.
get_task_tree Tasks as a nested tree of groups and subtasks.
get_dependency_graph What depends on what, broken dependencies, and cycles.
get_resource_load Tasks and person-days per person or team, optionally within a date window.
list_milestones, list_resources, list_tags The milestones, people/teams and tags defined in a project.

Create (add data, never remove it)

create_project A new, empty project owned by you.
add_task, bulk_add_tasks One task, or a whole plan in a single step with dependencies, subtasks, tags and people.
add_milestone, add_resource, add_tag A milestone, a person/team, or a tag.

Modify or delete (can change or remove existing data)

update_task, update_milestone Rename, reschedule, set progress, color, notes, dependencies, tags or people.
move_task Reorder a task in the list without changing its dates.
set_task_parent, create_task_group Nest tasks as subtasks, un-nest them, or group them under a new phase.
assign_resources, tag_tasks Add, replace or remove people and tags on several tasks at once.
delete_task, delete_milestone, delete_resource, delete_tag Delete one item. Deletions can't be undone.

There is no tool to delete a project, to change who a project is shared with, or to touch your billing. Those stay in the web app.

8. Example prompts

Create a ProGantt project called “Website relaunch” and draft the plan: discovery, design, build and launch phases, with realistic durations and dependencies between them.

Claude creates the project and adds the whole plan in one step, with phases as groups, subtasks inside them and the order expressed as dependencies.

In my “Website relaunch” project, the design phase is running a week late. Push it and everything that depends on it back by 7 days, and tell me the new launch date.

Claude reads the dependency graph, moves the affected tasks and reports the result.

Who is overloaded in “Mobile app v2” over the next two weeks? Suggest how to rebalance the work and apply it if I agree.

Claude checks the load per person for that window, proposes reassignments and, once you confirm, updates the tasks.

Mark “API integration” as 60% done, tag it as “backend” and assign it to Maria.

Claude finds the task by its title and applies all three changes in a single update.

What's still blocking the “Beta release” milestone in my Q4 roadmap?

Claude reads the project and lists the unfinished tasks that the milestone depends on.

9. Permissions and safety

10. Data and privacy

The connector reads and writes only your ProGantt project data. It does not read your conversations with Claude. For each tool call we record the tool name, whether it succeeded and how long it took — never the arguments or the content. Access tokens are stored only as hashes. The full details are in our Privacy Policy.

11. Troubleshooting

“Couldn't reach the MCP server” when adding the connector

Check that the URL ends in /mcp: https://mcp.progantt.com/mcp. The bare domain doesn't serve the MCP endpoint.

The assistant connects but finds no projects

You probably signed in with a different account from the one you use in ProGantt, for example Google instead of Microsoft. Disconnect the connector in your client, connect again and pick the right account.

“You have read-only access to project …”

You are a viewer on that project. Ask its owner to make you an editor.

“You do not have access to project …” or “Project … not found”

The project was deleted, or its owner stopped sharing it with you. Ask Claude to list your projects again.

Token-based client returns 401 / “Token not recognized”

The token was revoked or mistyped. Generate a new one from Connect AI and update your client config. If you've reached your plan's token limit, revoke an unused one first.

Claude asks you to sign in again

Sessions renew automatically, but after about 30 days without use you'll be asked to sign in again. Click Connect and sign in with the same Google or Microsoft account.

A task starts on a slightly different date than expected

When you don't give a start date, tasks created from the connector start today at 00:00 UTC, while the web app uses your local midnight. Give an explicit date to avoid the difference.

12. Support

Questions, bug reports and feedback: support@progantt.com. If you have an account, you can also use the support chat inside the app.

ProGantt Flow is an independent product and is not affiliated with or endorsed by Anthropic. Claude is a trademark of Anthropic, PBC.