Connect Claude & Cursor via MCP

What you can do

Ask in plain English, your AI assistant handles the rest

Here are a few examples of what you can say to an assistant once MCP Access is connected.

You Show me the open tickets in TDL and group them by priority.

You Create a bug in TDL titled "CSV importer fails on quoted commas" with high priority.

You Move TDL-47 to review and leave a comment linking to the pull request.

You Summarise what my team shipped this week across all my projects.

You Turn this email thread into a properly formatted ticket in the Support project.

You Which tickets assigned to me are in review? Add a comment pinging Alice on each.

You Execute ticket TDL-112.

You Break this ticket into checklist items: design, implement, write tests, update changelog.

You How much time did I log on TDL-47 this sprint, and which entries were longer than an hour?

Get connected

Three steps, about two minutes

1

Create a token

In Profile - MCP Access, name your token, pick read-only or read/write, and select which projects it may access.

2

Add the server to your client

Paste the server URL and your token into Claude Code, Claude Desktop, Cursor, OpenAI Codex, ChatGPT, or any other MCP client. Examples for each are below.

3

Start chatting

Ask your AI assistant to list projects, create tickets, or move work forward. Revoke the token any time from the same screen.

Claude Code, Claude Desktop, Cursor, Zed (.mcp.json)

{
  "mcpServers": {
    "todo4you": {
      "type": "http",
      "url": "https://mcp.todo4you.com/mcp",
      "headers": {
        "Authorization": "Bearer t4y_mcp_your_token_here"
      }
    }
  }
}

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

# Codex talks to MCP servers over stdio. The mcp-remote bridge
# wraps our HTTP server so Codex can speak to it.
[mcp_servers.todo4you]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.todo4you.com/mcp",
  "--header",
  "Authorization:Bearer t4y_mcp_your_token_here"
]

After saving, restart Codex (codex). The Todo4you tools will appear when you ask Codex what it can do.

ChatGPT (Settings → Connectors)

# In ChatGPT (web or desktop):
1. Open Settings → Connectors → Create.
2. Fill in the form:
   Name:               Todo4you
   MCP Server URL:     https://mcp.todo4you.com/mcp
   Authentication:     Custom (HTTP header)
   Header name:        Authorization
   Header value:       Bearer t4y_mcp_your_token_here

3. Trust the connector when prompted, then enable it   inside any chat from the Connectors button.

ChatGPT requires a paid plan that includes custom MCP connectors. The connector inherits your token's scope - read-only or read/write - and only the projects you assigned to it.

What it exposes

A complete toolset

The MCP server exposes a focused set of well-defined tools, each mapped to a REST API call. Read tools work with any token; write tools require read/write scope.

Tool	Scope	Description
Projects
`list_projects`	read	List the projects the token is scoped to.
`project_stats`	read	Open-ticket counts per status for a project.
`project_statuses`	read	Status slugs and categories configured on the project.
`list_project_members`	read	List members of a project with their user IDs and roles.
`list_tags`	read	List the tags defined in a project.
Tickets
`list_tickets`	read	List non-archived tickets, optionally filtered by status.
`search_tickets`	read	Full-text search tickets in a project by title or description.
`get_ticket`	read	Full ticket detail: description, comments, checklist, tags, assignees, blockers, attachments, and time summary.
`create_ticket`	write	Create a ticket with title, type, priority, and description.
`update_ticket`	write	Update title, description, type, priority, deadline, estimation, or tags.
`move_ticket`	write	Move a ticket to a different status slug.
`archive_ticket`	write	Archive a ticket, hiding it from the board.
`unarchive_ticket`	write	Restore an archived ticket back onto the board. Project managers only.
`delete_ticket`	write	Permanently delete a ticket. Creator or project manager only.
`assign_member`	write	Assign a project member to a ticket.
`unassign_member`	write	Remove an assignee from a ticket.
Comments
`list_comments`	read	List the comment thread on a ticket.
`add_comment`	write	Add a Markdown comment to a ticket.
`update_comment`	write	Edit an existing comment. Authors only.
`delete_comment`	write	Delete a comment. Author or project manager only.
Checklist and blockers
`add_checklist_item`	write	Add a checklist (subtask) item to a ticket.
`toggle_checklist_item`	write	Toggle a checklist item between open and done.
`update_checklist_item`	write	Update the text of a checklist item.
`delete_checklist_item`	write	Delete a checklist item.
`add_blocker`	write	Mark another ticket as a blocker of this ticket.
`remove_blocker`	write	Remove a blocker relationship.
Tags
`create_tag`	write	Create a new tag in a project.
`update_tag`	write	Update a tag's name or color.
`delete_tag`	write	Delete a tag from a project.
Time tracking
`list_time_entries`	read	List all time entries on a ticket with a total in minutes.
`running_timer`	read	Get the current user's running or paused timer, if any.
`start_timer`	write	Start a live timer on a ticket.
`stop_timer`	write	Stop a running or paused timer and record the elapsed minutes.
`pause_timer`	write	Pause a running timer, preserving accumulated minutes.
`resume_timer`	write	Resume a paused timer.
`add_time_entry`	write	Log a manual time entry on a ticket.
`update_time_entry`	write	Update the minutes on a time entry.
`delete_time_entry`	write	Delete a time entry.
Documentation
`list_doc_folder`	read	List the contents (subfolders and articles) of a documentation folder, or the root when no folder ID is given. Only works on projects that have documentation enabled.
`get_doc_article`	read	Get a documentation article including its Markdown content, attachments, and comments.
`create_doc_folder`	write	Create a new documentation folder, optionally inside a parent folder.
`create_doc_article`	write	Create a new documentation article with Markdown content, optionally inside a folder.
`update_doc_article`	write	Update an article's title, content, or folder.

Built with guardrails

You stay in control of what your AI assistant can touch

Hashed storage

Tokens are shown once and stored SHA256-hashed. We cannot recover them if lost.

Least privilege

A token cannot change account settings, membership, billing, passkeys, or 2FA, even on read/write scope.

Instant revoke

Delete the token in your profile - the next request fails. No caching, no delay.

Manage your project by chatting with your AI assistant

Ask in plain English, your AI assistant handles the rest

Three steps, about two minutes

Create a token

Add the server to your client

Start chatting

A complete toolset

You stay in control of what your AI assistant can touch

Let your AI assistant pull its weight

Manage your project by chatting with your AI assistant

Ask in plain English, your AI assistant handles the rest

Three steps, about two minutes

Create a token

Add the server to your client

Start chatting

A complete toolset

You stay in control of what your AI assistant can touch

Let your AI assistant pull its weight

Coming soon