Timelink MCP server

Connect Timelink 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 TimelinkBook a demo

What you can do with the Timelink MCP server

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

  • Use the get client tool in Timelink
  • Use the update service tool in Timelink
  • Use the create project tool in Timelink
  • Use the list projects tool in Timelink
  • Use the delete time entry tool in Timelink
  • Use the update project tool in Timelink

Supported Tools

get_client

Get Client

DEPRECATED — use `get_record` instead. Retrieve details of a specific client by ID. Returns full client information including name, billing status, active status, and external ID.

update_service

Update Service

DEPRECATED — use `manage_service_record` instead. Update an existing service (activity type) in Timelink. Only the provided fields will be updated; omitted fields remain unchanged.

create_project

Create Project

DEPRECATED — use `manage_project_record` instead. Create a new project in Timelink. Projects can be linked to a client and used to categorize time entries. Configure billing, active status, and an external ID for syncing.

list_projects

List Projects

DEPRECATED — use `list_records` instead. Retrieve all projects in Timelink. Returns project details including name, associated client, billing status, and active status. Use this to find project IDs for time entries.

delete_time_entry

Delete Time Entry

DEPRECATED — use `manage_time_entry_record` instead. Permanently delete a time entry from Timelink. This action cannot be undone.

update_project

Update Project

DEPRECATED — use `manage_project_record` instead. Update an existing project in Timelink. Only the provided fields will be updated; omitted fields remain unchanged. Can reassign the project to a different client.

update_client

Update Client

DEPRECATED — use `manage_client_record` instead. Update an existing client in Timelink. Only the provided fields will be updated; omitted fields remain unchanged.

create_service

Create Service

DEPRECATED — use `manage_service_record` instead. Create a new service (activity type) in Timelink. Services define the type of work performed and can be assigned to time entries.

get_project

Get Project

DEPRECATED — use `get_record` instead. Retrieve details of a specific project by ID. Returns full project information including name, associated client, billing and active status.

get_time_entry

Get Time Entry

DEPRECATED — use `get_record` instead. Retrieve a specific time entry by ID. Returns full details including start/end times, associated client, project, service, and billing information.

update_time_entry

Update Time Entry

DEPRECATED — use `manage_time_entry_record` instead. Update an existing time entry in Timelink. Only the provided fields will be updated; omitted fields remain unchanged. Can modify times, description, assignments, and billing status.

search_time_entries

Search Time Entries

DEPRECATED — use `list_records` instead. Search and filter time entries in Timelink. Filter by date range, client, project, service, or external ID. Returns all matching time entries with their full details.

list_users

List Users

DEPRECATED — use `list_records` instead. Retrieve all users in the Timelink workspace. Returns user details including names and email addresses. Useful for finding user IDs to assign to time entries or to see who is part of the team.

list_clients

List Clients

DEPRECATED — use `list_records` instead. Retrieve all clients in Timelink. Returns client details including name, billing status, and active status. Use this to find client IDs for creating projects or time entries.

list_services

List Services

DEPRECATED — use `list_records` instead. Retrieve all services (activity types) in Timelink. Services categorize the type of work being done in time entries. Use this to find service IDs for creating or filtering time entries.

create_time_entry

Create Time Entry

DEPRECATED — use `manage_time_entry_record` instead. Create a new time entry in Timelink. Requires start and end times. Optionally assign to a client, project, service, and user, and set billing and payment status.

create_client

Create Client

DEPRECATED — use `manage_client_record` instead. Create a new client in Timelink. Clients can be associated with projects and time entries. Configure billing, active status, color, and an external ID for syncing with other systems.

get_current_token

Get Current Token

Identify the connected API token and inspect its provider-reported abilities and timestamps. This returns credential metadata, not a user profile or the secret token.

manage_time_entry_record

Manage Time Entry Record

Create, update, or permanently delete a time entry using current Timelink string IDs. Creating requires userId and start; end may be omitted for a running entry. Discover IDs with list_records and company-specific requirements with get_time_entry_fields. Delete requires only action and id.

manage_service_record

Manage Service Record

Create, update, or permanently delete a service using Timelink string IDs. Use list_records to discover IDs. Supports billable status and a default time entry description. Delete requires only action and id.

get_time_entry_fields

Get Time Entry Required Fields

Retrieve the company-specific field names required for time entries before creating or updating entries.

get_company

Get Company

Identify the connected company and retrieve its provider-reported contact, subscription, integration, and settings information.

get_record

Get Record

Retrieve one client, project, service, user, or time entry by its current Timelink string ID. Use list_records to discover IDs. Preserves the original provider record.

manage_project_record

Manage Project Record

Create, update, or permanently delete a project using Timelink string IDs. Use list_records to discover project and client IDs. Update changes supplied fields; delete requires only action and id.

list_active_time_entries

List Active Time Entries

List a provider page of running time entries with their string IDs, original fields, and pagination metadata.

list_records

List Records

Discover clients, projects, services, users, or time entries using current Timelink string IDs. Returns one provider page and its original pagination metadata. Use these IDs with get_record and the manage_*_record tools.

manage_client_record

Manage Client Record

Create, update, or permanently delete a client using Timelink string IDs. Use list_records to discover IDs. Update changes only supplied fields; delete requires only action and id.

Connect Timelink 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 Timelink in Metorial. In your Metorial portal, enable the Timelink 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 Timelink tools.

Run Timelink through the Metorial gateway

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

  • Give Timelink and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Timelink 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 Timelink

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.

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.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Jira

Create, read, update, and delete issues across projects. Search issues using JQL queries. Manage projects, boards, sprints, and epics for agile workflows. Log work time, add comments and attachments, and transition issues through workflow statuses. Create and manage project versions/releases, issue links, filters, and dashboards. Query users, groups, and permissions.

Technical notes for Timelink

Track and manage time entries for individuals and teams. Create, update, search, and delete time entries with start/end times, descriptions, and billable status. Manage clients, projects, and services (activity types) associated with time tracking. Retrieve user information. Filter time entries by date range, client, project, or service.

Frequently asked questions

Common questions about connecting Timelink to AI agents with Metorial.

  1. How many tools does the Timelink MCP server have?
    The Timelink MCP server exposes 27 tools, including Get Client, Update Service, Create Project. Each one is governed and traced through Metorial.
  2. Timelink 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 Timelink MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Timelink and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Timelink MCP server yourself or use the hosted gateway.

Connect Timelink to production AI agents

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

Book a demoDeploy Timelink