Docs

MCP setup

One tool set over two transports: remote over HTTPS, or local through the CLI.

Local

Add Symphony to your MCP client's config. The CLI must be installed and signed in.

{
  "mcpServers": {
    "symphony": {
      "command": "symphony",
      "args": [
        "mcp"
      ]
    }
  }
}

Remote

Add https://api.opensymphony.io/mcp as a remote server in your client. It opens Symphony in your browser, where you sign in and allow it.

Access

A client asks for read-only or full access, and the page where you allow it says which. Read-only can read and list; full access can do everything you can do in Symphony, as you. A personal API key from symphony token create works here too, with the scope you gave it.

Tools

  • projects_list: Lists the projects with their open task count and next due date, one page at a time.
  • statuses_list: Lists a project’s statuses in board order, each with its category, one page at a time.
  • labels_list: Lists the labels, shared by every project, one page at a time.
  • tasks_list: Lists tasks that are not deleted, in board order, one page at a time. Narrow it by project, status, priority, label, overdue (open and due before today in your time zone), blocked (blocked by an open task) and updated_since.
  • tasks_get: Shows one task with its relations (blocks, blocked by, related) and its sub-tasks.
  • tasks_create: Creates a task in a project, by default in its first Todo status.
  • tasks_update: Edits a task. Moving it to another project moves its sub-tasks too.
  • tasks_done: Marks a task done: it takes its project’s first Done status.
  • capture: Files one line as a task, read like quick capture: the first date sets the due day, !urgent, !high, !medium, !low or !1 to !4 the priority, and #name the project. Without #name, the CLI files it to the project it last captured to; offline, the CLI keeps it and files it on its next run.
  • project_get: Shows one project with its open task count, next due date and statuses.
  • task_history: Lists what changed, oldest first: one task’s changes, or with only since, every task’s changes from that time on.
  • comments_list: Lists a task’s comments, oldest first; each body is Markdown.
  • comment_add: Adds a comment to a task.
  • relations_add: Relates a task to another: it blocks it, is blocked by it, or is related to it.
  • relations_remove: Removes every relation between two tasks, in either direction.
  • triage_list: Lists the asks waiting in triage, newest first, snoozed ones whose time has passed included.
  • triage_accept: Makes an ask a task. Each field left out takes the ask’s suggestion: its title, project, priority and due date.
  • triage_dismiss: Dismisses an ask. The person can restore it in the app.
  • today_get: Shows today in your time zone: Today’s top 3 tasks, the calendar events that overlap the day, and how many asks wait in triage.
  • repos_list: Lists the git repositories in the folders you allowed (each folder itself, or a folder directly inside it), with the branch, the last commit and how many files have changes. Local only.
  • repo_log: Lists a git repository’s commits on its current branch, newest first. The repository must be inside a folder you allowed. Local only.