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.