Teamwork MCP server

Connect Teamwork to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

Deploy TeamworkBook a demo

What you can do with the Teamwork MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the manage notebook tool in Teamwork
  • Use the list people tool in Teamwork
  • Use the get task tool in Teamwork
  • Use the get activity tool in Teamwork
  • Use the list projects tool in Teamwork
  • Use the manage task list tool in Teamwork

Supported Tools

manage_notebook

Manage Notebook

Create, update, or delete a notebook (wiki-style document) in a Teamwork project. Notebooks support rich content, categories, and tags.

list_people

List People

Retrieve people (users) from Teamwork. Can list all people on the site or filter by project membership. Supports search by name.

get_task

Get Task

Retrieve detailed information about a specific Teamwork task, including its status, assignees, dates, priority, and estimated time.

get_activity

Get Activity

Retrieve the latest activity feed from Teamwork. Shows recent actions across the site or within a specific project, including task updates, comments, file uploads, and more.

list_projects

List Projects

Retrieve a list of projects from Teamwork. Supports filtering by status, company, category, and search term. Use pagination to navigate large result sets.

manage_task_list

Manage Task List

Create a task list in a Teamwork project, or list existing task lists for a project. Task lists are containers that organize tasks within a project.

manage_project_people

Manage Project People

Add or remove people from a Teamwork project. Manage project membership by specifying person IDs to add or remove.

manage_time_entry

Manage Time Entry

Create, update, or delete a time entry in Teamwork. Log time against a project or task with hours, minutes, description, and billable status.

manage_project

Manage Project

Create, update, or delete a Teamwork project. Use **create** to start a new project, **update** to modify an existing one, or **delete** to permanently remove it.

list_tasks

List Tasks

Retrieve tasks from Teamwork. Can list all tasks, tasks for a specific project, or tasks in a specific task list. Supports filtering by assignee, priority, dates, tags, and search term.

manage_task

Manage Task

Create, update, complete, reopen, or delete a Teamwork task. Supports setting assignees, due dates, priorities, estimated time, and tags.

manage_message

Manage Message

Create, update, or delete a message (discussion post) in a Teamwork project. Messages support titles, body content, categories, and tags.

get_project

Get Project

Retrieve detailed information about a specific Teamwork project by its ID, including status, dates, company, and description.

manage_milestone

Manage Milestone

Create, update, complete, reopen, or delete a milestone within a Teamwork project. Milestones can have deadlines, responsible parties, and tags.

list_time_entries

List Time Entries

Retrieve time entries from Teamwork. Can filter by project, task, date range, and user. Returns logged hours, descriptions, and billable status.

manage_comment

Manage Comment

Create, update, or delete a comment on a Teamwork resource. Comments can be added to tasks, milestones, notebooks, and files.

get_current_user

Get Current User

Retrieve the authenticated Teamwork user, including their person ID, company, and administrator status.

list_milestones

List Milestones

Find Teamwork milestones across accessible projects or within one project. Returns milestone IDs for updates, completion, and reopening.

Connect Teamwork to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Teamwork in Metorial. In your Metorial portal, enable the Teamwork MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Teamwork tools.

Run Teamwork through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Teamwork and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Teamwork tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Teamwork

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Teamwork

Manage projects, task lists, and tasks with support for assignees, due dates, priorities, dependencies, subtasks, and custom fields. Track time entries and timers against projects and tasks. Create and manage milestones, calendar events, messages, comments, notebooks, files, invoices, expenses, and budgets. Organize people and companies, assign roles and teams, and manage project permissions. Monitor project health with status updates and portfolio boards. Define custom fields, tags, and categories to extend and organize data.

Frequently asked questions

Common questions about connecting Teamwork to AI agents with Metorial.

  1. How many tools does the Teamwork MCP server have?
    The Teamwork MCP server exposes 18 tools, including Manage Notebook, List People, Get Task. Each one is governed and traced through Metorial.
  2. Teamwork exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Teamwork MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Teamwork and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Teamwork MCP server yourself or use the hosted gateway.

Connect Teamwork to production AI agents

See how Metorial gives your team governed access to Teamwork, with tracing and security controls built in.

Book a demoDeploy Teamwork