Getting Started
Connect your AI tools to Parallel
Overview
Parallel exposes an MCP (Model Context Protocol) server that AI clients can connect to. This allows AI agents to:
- View, create, and manage tasks
- Track goals and progress
- Add comments and attachments
- Link git commits to tasks
Authentication
There are two ways to authenticate:
OAuth 2.1 (Recommended)
Most MCP clients (Cursor, Claude Code, Claude Desktop) support OAuth automatically. When you first connect, your browser will open to authorize the connection.
API Key
For clients that don't support OAuth, or if you prefer a simpler setup:
- Go to Settings → API Keys in the Parallel web app
- Click Create API Key
- Copy the key (it's only shown once)
- Use it as a Bearer token in your MCP client configuration
MCP Server URL
https://mcp.parallel.so/api/mcpAvailable Tools
| Tool | Description | Scope |
|---|---|---|
list_tasks | List active tasks with filters | tasks:read |
get_task | Get task details (subtasks, comments) | tasks:read |
create_task | Create a new task | tasks:write |
update_task | Update task fields | tasks:write |
set_status | Change task status | tasks:write |
delete_task | Delete a task | tasks:write |
search_tasks | Search by keyword | tasks:read |
get_today_tasks | Tasks due today/overdue | tasks:read |
get_review_tasks | Tasks in review | tasks:read |
list_goals | List goals | goals:read |
get_goal | Goal with progress stats | goals:read |
create_goal | Create a goal | goals:write |
update_goal | Update a goal | goals:write |
list_comments | List task comments | comments:read |
add_comment | Add a comment | comments:write |
list_attachments | List task attachments | attachments:read |
read_attachment | Read text attachment | attachments:read |
create_attachment | Create text attachment | attachments:write |
link_commits | Link git commits | tasks:write |
add_relation | Add task relation | tasks:write |
remove_relation | Remove task relation | tasks:write |