WEEEK (smart)

Mark a WEEEK task complete, or reopen it (completed:false).

Create a board in a WEEEK project (by name or id).

Create a column on a WEEEK board. Pass the board by id, or by name together with its `project`.

Create a CRM contact: `first_name`, optional middle and last names, `organizations` and `tags` by name or id, and emails and phones as plain strings.

Create a custom field in a scope (global, a project, a board or a funnel) with a `name` and a `type`: text, number, boolean, datetime, select, multiselect, member, contact, link or approval. Number fields take number_format, precision and currency_id; boolean fields boolean_style. Add a select field's choices with weeek_add_field_option.

Create a CRM deal in a `status` (by id, or by name with `funnel`): `title`, optional amount, outcome (won, lost, archived), description, assignees, organizations, contacts and tags by name, and custom-field `fields` by name (fields need `funnel`).

Create a CRM funnel with a `name`, an optional `currency` (code or id) and `private` (default false).

Create a CRM organization: `name`, optional addresses, emails and phones (plain strings) and one `responsible` member (by name or id).

Create a WEEEK portfolio, optionally inside a `parent` portfolio (name or id).

Create a WEEEK project. Optional description, `private` (default false) and a `portfolio` (name or id) to file it under.

Add a status (stage) to a CRM funnel (by name or id).

Create a WEEEK workspace tag with the given title; WEEEK assigns its colour, which weeek_update_tag can change.

Create a WEEEK task. Accepts project/column/assignee by NAME or id, a natural-language `due` date, a priority (low, medium, high, hold), a type (action, meet, call), a `parent` task id for a subtask, and custom-field values in `fields` by field name (global and project fields). One call — no need to look up ids first. Omit `assignee` to self-assign; to change assignees later use weeek_add_assignees / weeek_remove_assignees.

Create up to 50 WEEEK tasks in one call. Each item takes the same fields as weeek_create_task: `title` and `project` (name or id) are required; `column`, `assignee`, `due`, `description`, `priority`, `type`, `parent` and `fields` are optional. Items are created in order and one bad name does not abort the batch: the reply is one entry per item, `{ ok: true, task }` or `{ ok: false, error, candidates? }`.

Permanently delete a WEEEK board and its columns. Irreversible; requires confirm:true. Pass the board by id, or by name together with its `project`.

Permanently delete a WEEEK board column. Irreversible; requires confirm:true. Pass the column by id, or by name together with its `board` (and `project` when the board is a name).

Permanently delete one comment from a WEEEK task. Irreversible; requires confirm:true.

Permanently delete a CRM contact (by full name or id). Irreversible; requires confirm:true.

Permanently delete a custom field (by name or id, inside its scope) together with every value held in it. Irreversible; requires confirm:true.

Permanently delete a CRM deal (by id, or by title with `funnel`/`status`). Irreversible; requires confirm:true.

Remove one address, email or phone (`detail`: its current value or id) from a CRM organization or contact. Irreversible; requires confirm:true.

Permanently delete one choice of a select/multiselect custom field (option by name or id); tasks that chose it lose that value. Irreversible; requires confirm:true.

Permanently delete a CRM funnel (by name or id) with its statuses and deals. Irreversible; requires confirm:true.

Permanently delete a CRM organization (by name or id). Irreversible; requires confirm:true.

Permanently delete a WEEEK portfolio (by name or id). Irreversible; requires confirm:true.

Permanently delete a WEEEK project and everything in it. Irreversible; requires confirm:true. An archived project is not in the project list, so give it by id, not by name. To hide a project without losing it use weeek_archive_project.

Permanently delete a funnel status (by id, or by name with its `funnel`) and the deals in it. Irreversible; requires confirm:true.

Permanently delete a WEEEK tag (by title or id) from the workspace and every task that carries it. Irreversible; requires confirm:true.

Permanently delete a WEEEK task by id. Irreversible — the task is removed, not just completed. Requires confirm:true; to merely close a task use weeek_complete_task instead.

Delete a time entry from a WEEEK task. Irreversible; requires confirm:true.

Unlink a CRM contact from a deal or an organization (exactly one). Requires confirm:true. Returns the deal or organization.

Unlink an organization (by name or id) from a CRM deal. Requires confirm:true. Returns the deal.

Read one WEEEK attachment by id. For an image WEEEK hosts itself this returns the image, so a task whose requirements live in a screenshot can actually be read instead of guessed at from the surrounding text; anything else comes back as metadata. Ids come from a task's `attachments` list (weeek_get_task).

Get one CRM contact by full name or id: names, organization ids, emails, phones and tags.

Get one CRM deal: by its id alone, or by title together with its `funnel` or `status`. Returns amount, outcome, assignees, organizations, contacts, tags, tasks, custom-field values and attachments.

Get one CRM funnel by name or id.

Get one CRM organization by name or id: responsible member, addresses, emails, phones, contact ids and tags.

Get one WEEEK portfolio by name or id: parent portfolio and privacy.

Get the profile of the token's owner: member id, name, email, language, time zone. The id is what a task's `assignees` and `watchers` hold for you.

Get one WEEEK project by name or id: description, privacy, status, portfolio and team member ids.

Get one funnel status by id, or by name together with its `funnel`.

Get one WEEEK tag by title or id.

Get one WEEEK task by id: assignees, watchers, parent and subtasks, priority, dates, tags, locations, time entries, attachments and custom-field values (`customFields`, option names shown).

Get the WEEEK workspace the token belongs to: id, title, description, whether it is a personal workspace.

List the boards of a WEEEK project (by name or id): id, name, privacy. Use it to find a board for weeek_move_task or weeek_list_columns.

List the columns of a WEEEK board: id, name, boardId. Pass the board by id, or by name together with its `project`.

List the comments on a WEEEK task: id, author member id, markdown, reply parent, timestamps. Paged; `hasMore` says whether to call again with a larger offset.

List CRM contacts, optionally narrowed by `search` text, sorted by alphabet or updatedAt. Paged; `hasMore` is true when a full page came back.

List the currencies WEEEK offers for funnels and deal amounts: id, name, code, symbol.

List the custom fields of one scope — global (every task), a project, a board or a CRM funnel: id, name, type, number/boolean settings and select options. A board's fields are read off its tasks (the API lists them nowhere else), so an empty board shows none.

List CRM deals in one `status` (by id, or by name with `funnel`) or in every status of a `funnel`: optional `search` text and `sort`. Paged per status: `limit` and `offset` apply to each status, so a funnel-wide list returns up to `limit` × statuses deals; `hasMore` says whether any status has more.

List the WEEEK CRM funnels: id, name, currency, privacy, deal count and amount, team and custom fields.

List WEEEK workspace members (id + display name). Any tool that takes an assignee, watcher or member accepts these names directly; use this to see who exists.

List CRM organizations, optionally narrowed by `search` text, sorted by alphabet or updatedAt. Paged; `hasMore` is true when a full page came back.

List WEEEK portfolios (folders of projects), optionally narrowed by `search` text or a `parent` portfolio (name or id). Paged; `hasMore` says whether to call again with a larger offset.

List WEEEK projects: id, name, isPrivate, status and portfolioId. Use weeek_get_project for a project's description and team.

List the statuses (stages) of a CRM funnel (by name or id): id, name, deal count and amount.

List the workspace's WEEEK tags: id, title, colour. weeek_update_task takes tags by these titles.

List WEEEK tasks with server-side filters: project, board, column, assignee (userId), completion, free-text `search`, priority, type, a single `day` or a startDate–endDate range (dd.mm.yyyy), completion dates. Set allPages=true together with userId, startDate, and endDate to fetch every matching page inside the connector without returning unrelated workspace pages.

Reorder a WEEEK board: place it right after the board `after` (name or id in the same project), or first with after:null. Pass boards by id, or by name together with `project`.

Reorder a WEEEK board column: place it right after the column `after` (name or id on the same board), or first with after:null. Pass columns by id, or by name together with `board` (and `project` when the board is a name).

Reorder a CRM funnel's custom fields: place `field` right after or right before another field of the same funnel (names or ids; exactly one of the two). Task-manager fields have no order the API exposes.

Move a CRM deal: `to_funnel` (another funnel), `to_status` (a status of its funnel, or of `to_funnel`), and/or `after` — the deal it goes right after in that status (null = first). Pass at least one; `after` with `to_funnel` needs `to_status`.

Reorder a task inside a CRM deal: place `task_id` right after the task `after` (a task id; null = first).

Reorder the choices of a select/multiselect custom field: place `option` right after or right before another option (names or ids; exactly one of the two).

Move a WEEEK task to a column (by name or id, scoped to the given board) on that board. Find board ids with weeek_list_boards.

Unassign one or more members (by name or id) from a WEEEK task. Requires confirm:true. Returns the task.

Take a workspace tag (by title or id) off a deal, an organization or a contact — exactly one. Requires confirm:true. Returns the object.

Unassign members (by name or id) from a CRM deal. Requires confirm:true. Returns the deal.

Detach a task (by id) from a CRM deal. Requires confirm:true.

Remove a WEEEK task from one of its projects (by name or id); the task keeps its other projects. Requires confirm:true.

Stop members (by name or id) watching a WEEEK task. Requires confirm:true. Returns the task.

Make a WEEEK task a subtask of `parent` (a task id), or pass parent:null to detach it and make it top-level again.

Start (running:true) or stop (running:false) WEEEK's time tracker on a task for the token's owner. Stopping records the elapsed time as an entry; weeek_get_task lists a task's `timeEntries`.

Move a global, project or board custom field to another scope: `to` global, a project (`to_project`) or a board (`to_board` by id, or by name with `to_project`). Funnel fields cannot leave their funnel.

Rename a WEEEK board. Pass the board by id, or by name together with its `project`.

Rename a WEEEK board column. Pass the column by id, or by name together with its `board` (and `project` when the board is a name).

Change a CRM contact's first, middle or last name (contact by full name or id). Names you omit keep their value; organizations, emails, phones and tags have their own tools.

Rename a custom field (by name or id, inside its scope) or change its number/boolean settings; settings you omit keep their value. The type cannot change.

Change a CRM deal (by id, or by title with `funnel`/`status`): title, amount (null clears), outcome (won, lost, archived; null reopens), custom-field `fields` by name (null clears), and the assignees, organizations, contacts and tags (each list replaces: unlisted ones are removed). Fields you omit keep their value. The description can only be set on create — the API ignores it afterwards.

Change one address, email or phone of a CRM organization or contact: `detail` is its current value or id, `value` the new one.

Rename or recolour one choice of a select/multiselect custom field (option by name or id). Fields you omit keep their current value.

Rename a CRM funnel (by name or id) or change its currency or privacy. Fields you omit keep their current value.

Rename a CRM organization (by name or id) or change its `responsible` (a member by name or id; null clears). Addresses, emails and phones are changed with the detail tools.

Rename a WEEEK portfolio (by name or id).

Rename a WEEEK project (by name or id) or change its privacy or colour (# and six hex digits). Fields you omit keep their current value. An archived project is not in the project list, so give it by id.

Rename a funnel status (by id, or by name with its `funnel`).

Change a WEEEK tag's title or colour (tag by title or id). Fields you omit keep their current value.

Update a WEEEK task: title, natural-language `due` and `start` dates (`start` goes with the due date — `due` or the task's own — because the API refuses one alone; some plans refuse start dates), priority (low, medium, high, hold), type (action, meet, call), `duration` in minutes, `tags` by name or id (replaces; an empty list clears), and `fields`: custom-field values by field name (options and members by name; null clears; other fields keep their values). Description is NOT updatable — the API ignores it; set it on create. Assignees, watchers, parent and projects have their own tools.

Change a time entry on a WEEEK task (`entry_id` from the task's `timeEntries`): any of date, minutes, member, overtime. Fields you omit keep their current value.

Return this MCP server's name and version, so callers can check which build is running.