MCP server

PureWorks in your AI app.

One MCP server for PureBase, PureSpark and PurePulse. Your AI app reads and changes your work as you, with a personal access token you make and can revoke.

Server address
https://mcp.pureworks.io/mcp
  • It works as you

    Everything it changes shows your name, and it can't do anything you couldn't do yourself.

  • Your token sets the limits

    Pick the products, Read or Read and change for each, and one organisation or all of yours. The app only sees the tools the token allows.

  • You can stop it

    Revoke the token and apps using it lose access within 30 seconds.

1. Make a token

On auth.pureworks.io, open Account › Access tokens › New token.

  1. We email you a code to check it's you.
  2. Name the token, pick the organisation, and set PureBase, PureSpark and PurePulse each to Off, Read, or Read and change.
  3. Pick when it expires: in 30, 90 or 365 days.
  4. Copy the token. You see it once. If you lose it, make a new one.

The same screen shows the steps below with your token already filled in.

2. Set up your app

Put your token where it says <your token>.

Claude Code

  1. Run this in a terminal.

    claude mcp add --transport http --scope user pureworks https://mcp.pureworks.io/mcp --header "Authorization: Bearer <your token>"
  2. In Claude Code, type /mcp. PureWorks shows as connected.

  3. Ask: “List my PureWorks workspaces.”

Codex

  1. Add this to ~/.codex/config.toml.

    [mcp_servers.pureworks]
    url = "https://mcp.pureworks.io/mcp"
    bearer_token_env_var = "PUREWORKS_TOKEN"
  2. Add this line to ~/.zshrc, or your shell’s profile.

    export PUREWORKS_TOKEN=<your token>
  3. Open a new terminal and run codex mcp list. PureWorks is on the list.

  4. Ask: “List my PureWorks workspaces.”

Cursor

  1. Add this inside “mcpServers” in ~/.cursor/mcp.json.

    "pureworks": {
      "url": "https://mcp.pureworks.io/mcp",
      "headers": { "Authorization": "Bearer <your token>" }
    }
  2. Restart Cursor. Settings › MCP shows PureWorks in green.

  3. Ask: “List my PureWorks workspaces.”

Claude Desktop

  1. Install Node.js 18 or later, if you don’t have it.

  2. In Claude, open Settings › Developer › Edit config, and add this inside “mcpServers” in claude_desktop_config.json.

    "pureworks": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.pureworks.io/mcp", "--header", "Authorization:${PUREWORKS_AUTH}"],
      "env": { "PUREWORKS_AUTH": "Bearer <your token>" }
    }
  3. Quit Claude and open it again.

  4. Ask: “List my PureWorks workspaces.”

3. What it can do

58 tools. A Read token gets only the tools marked Read.

Any token1

ToolWhat it doesNeeds
My workspacesmy_workspacesThe organisations and workspaces this token reaches, each with its products and whether the token can read or change them. Product tools take a workspace as "organisation/workspace" from here.Read

PureBase21

ToolWhat it doesNeeds
People, statuses, labelspurebase_lookupEverything a PureBase workspace needs for picking: your role, your Inbox, statuses, labels and label groups, spaces, projects, pins, people (with their user ids) and counts per view. Call it first to find ids.Read
Searchpurebase_searchSearch tasks (finished ones too), projects, pages and comments by words or key.Read
Projectspurebase_list_projectsEvery project in the workspace you can see, with open and done counts.Read
A projectpurebase_get_projectOne project: its description, space, dates and workflow (its statuses in board order).Read
List taskspurebase_list_tasksTasks in a view (inbox, mine, today, next7, someday; project or project_done with `project`), or across the workspace by filters alone, narrowed by any of: project, status ids or status types, assignee ("me", "none" or user ids), labels (any of them), and due (overdue, today, next7, none) or dueFrom/dueTo. Give a view, a project or a filter. Pages of up to 200: pass nextCursor back as cursor.Read
A taskpurebase_get_taskOne task with its description (as Markdown), status, assignee, labels, due date, sub-tasks and checklist.Read
Make a taskpurebase_create_taskMake a task, in your Inbox or a project. It's made as you.Read and change
Change a taskpurebase_update_taskChange any of a task's title, description (Markdown, replaces it), done, status, assignee, priority, due date, labels (replaces them), project or place. Only what you send changes.Read and change
Delete a taskpurebase_delete_taskDelete a task.Read and changeDestructive
Commentspurebase_list_commentsThe comments on a task or a page, oldest first. Give `task` or `page`.Read
Commentpurebase_add_commentComment on a task or a page, as you. Give `task` or `page`.Read and change
Task activitypurebase_task_activityWhat happened to a task: made, changed (which field, from and to), moved.Read
Add to a checklistpurebase_add_checklist_itemAdd an item to a task's checklist.Read and change
Tick or change a checklist itempurebase_update_checklist_itemTick, untick or reword a checklist item, by its id from purebase_get_task.Read and change
Attachmentspurebase_list_attachmentsA task's files, each with a download link that works for 10 minutes.Read
Pagespurebase_list_pagesPages in a project, or in every project you can see: title, code, parent and a preview.Read
Read a pagepurebase_get_pageA page as Markdown, with its version (send it back with purebase_update_page) and `unsupported`: anything on the page Markdown can't hold. Also its path, sub-pages and backlinks.Read
Make a pagepurebase_create_pageMake a page in a project, at the top or under another page, optionally with its text.Read and change
Edit a pagepurebase_update_pageReplace a page's text with Markdown. Send the version you read with purebase_get_page: if someone saved since, nothing changes and you get the page as it is now, with its new version. A page holding things Markdown can't hold can't be overwritten; the answer says which.Read and change
Rename a pagepurebase_rename_pageChange a page's title or icon.Read and change
Move a pagepurebase_move_pageMove a page, with its sub-pages, under another page or to the top, in its project or another.Read and change

PureSpark24

ToolWhat it doesNeeds
Fields and viewspurespark_lookupThe fields of leads, companies and people (keys, types, options: what filters and `custom` take), the saved views, and the menu counts.Read
List leadspurespark_list_leadsLeads, searched, filtered and sorted, a page at a time.Read
Lead boardpurespark_lead_boardLeads by status, as the board shows them: each status's count and its first cards.Read
Leads by statuspurespark_lead_groupsLeads grouped by status: each status's count and its first rows.Read
A leadpurespark_get_leadOne lead with its company, people and activity counts.Read
Make a leadpurespark_create_leadMake a lead with its main contact, and its company by name or slug.Read and change
Change a leadpurespark_update_leadChange a lead's title, status (closing needs closeReason), company, owner, value, next step or custom fields. Each change goes in its history.Read and change
Add a notepurespark_add_noteAdd a note to a lead's activity, as you.Read and change
Lead activitypurespark_lead_activityA lead's activity, newest first: notes, status changes, things from other products.Read
Lead historypurespark_lead_historyEvery change to a lead's fields, newest first.Read
Add a person to a leadpurespark_link_personAdd a person to a lead: an existing one by personSlug, or a new one by name.Read and change
Take a person off a leadpurespark_unlink_personTake a person off a lead. The person stays in PureSpark.Read and change
List companiespurespark_list_companiesCompanies, searched, filtered and sorted, a page at a time.Read
A companypurespark_get_companyOne company with its people and leads.Read
Company historypurespark_company_historyEvery change to a company's fields, newest first.Read
Make a companypurespark_create_companyMake a company.Read and change
Change a companypurespark_update_companyChange a company's name, website, industry, size or custom fields.Read and change
List peoplepurespark_list_peoplePeople, searched, filtered and sorted, a page at a time.Read
A personpurespark_get_personOne person with their companies and leads.Read
Person historypurespark_person_historyEvery change to a person's fields, newest first.Read
Add a personpurespark_create_personAdd a person, optionally at a company.Read and change
Change a personpurespark_update_personChange a person's name, email, phone or custom fields.Read and change
A person's feedbackpurespark_person_feedbackWhat this person asked for in PurePulse. Needs PurePulse on the token too.ReadAlso needs PurePulse
Put a person at a companypurespark_person_add_companyPut a person at a company, with their role there.Read and change

PurePulse12

ToolWhat it doesNeeds
People and areaspurepulse_lookupYour role, the areas (with ids), the people (with user ids) and the counts per list and area.Read
Where tasks can gopurepulse_task_targetsThe PureBase projects a task made from feedback can go to (your Inbox first). Needs PureBase on the token too.ReadAlso needs PureBase
Countspurepulse_countsHow many items are in each list (new, all, planned, done) and each area.Read
List feedbackpurepulse_list_itemsFeedback items in a list (new, all, planned, done), an area, or by search; newest received or asked first. A page at a time.Read
An itempurepulse_get_itemOne feedback item with every ask, its links (a PureBase task) and who asked. Parts from PureBase or PureSpark show only when the token has that product and you can see them there.Read
Add feedbackpurepulse_create_itemAdd feedback someone gave, for example after a call.Read and change
Change an itempurepulse_update_itemChange an item's title, status, owner, area, notify-on-done or whether it shows on the public board.Read and change
Merge itemspurepulse_merge_itemsMerge an item into another: its asks move there and it goes away.Read and changeDestructive
Commentspurepulse_list_commentsThe team's comments on an item.Read
Commentpurepulse_add_commentComment on an item, as you. public: true shows it on the public board as a team reply.Read and change
Item activitypurepulse_item_activityWhat happened to an item.Read
Make a PureBase taskpurepulse_make_taskMake a PureBase task from an item and link them. Needs PureBase "Read and change" on the token too.Read and changeAlso needs PureBase Read and change

Destructive: your app can ask you before it runs these.

4. Revoke a token

On auth.pureworks.io, open Account › Access tokens, then ··· › Revoke on the token. Apps using it lose access within 30 seconds.

  • Resetting your password revokes all your tokens.
  • A token stops on the date it expires. You get an email 7 days before.
  • An owner of an organisation can block a token there. It keeps working in your other organisations.