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.
https://mcp.pureworks.io/mcpIt 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.
- We email you a code to check it's you.
- Name the token, pick the organisation, and set PureBase, PureSpark and PurePulse each to Off, Read, or Read and change.
- Pick when it expires: in 30, 90 or 365 days.
- 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
Run this in a terminal.
claude mcp add --transport http --scope user pureworks https://mcp.pureworks.io/mcp --header "Authorization: Bearer <your token>"
In Claude Code, type
/mcp. PureWorks shows as connected.Ask: “List my PureWorks workspaces.”
Codex
Add this to
~/.codex/config.toml.[mcp_servers.pureworks] url = "https://mcp.pureworks.io/mcp" bearer_token_env_var = "PUREWORKS_TOKEN"
Add this line to
~/.zshrc, or your shell’s profile.export PUREWORKS_TOKEN=<your token>
Open a new terminal and run
codex mcp list. PureWorks is on the list.Ask: “List my PureWorks workspaces.”
Cursor
Add this inside “mcpServers” in
~/.cursor/mcp.json."pureworks": { "url": "https://mcp.pureworks.io/mcp", "headers": { "Authorization": "Bearer <your token>" } }Restart Cursor. Settings › MCP shows PureWorks in green.
Ask: “List my PureWorks workspaces.”
Claude Desktop
Install Node.js 18 or later, if you don’t have it.
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>" } }Quit Claude and open it again.
Ask: “List my PureWorks workspaces.”
3. What it can do
58 tools. A Read token gets only the tools marked Read.
Any token1
| Tool | What it does | Needs |
|---|---|---|
My workspacesmy_workspaces | The 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
| Tool | What it does | Needs |
|---|---|---|
People, statuses, labelspurebase_lookup | Everything 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_search | Search tasks (finished ones too), projects, pages and comments by words or key. | Read |
Projectspurebase_list_projects | Every project in the workspace you can see, with open and done counts. | Read |
A projectpurebase_get_project | One project: its description, space, dates and workflow (its statuses in board order). | Read |
List taskspurebase_list_tasks | Tasks 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_task | One task with its description (as Markdown), status, assignee, labels, due date, sub-tasks and checklist. | Read |
Make a taskpurebase_create_task | Make a task, in your Inbox or a project. It's made as you. | Read and change |
Change a taskpurebase_update_task | Change 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_task | Delete a task. | Read and changeDestructive |
Commentspurebase_list_comments | The comments on a task or a page, oldest first. Give `task` or `page`. | Read |
Commentpurebase_add_comment | Comment on a task or a page, as you. Give `task` or `page`. | Read and change |
Task activitypurebase_task_activity | What happened to a task: made, changed (which field, from and to), moved. | Read |
Add to a checklistpurebase_add_checklist_item | Add an item to a task's checklist. | Read and change |
Tick or change a checklist itempurebase_update_checklist_item | Tick, untick or reword a checklist item, by its id from purebase_get_task. | Read and change |
Attachmentspurebase_list_attachments | A task's files, each with a download link that works for 10 minutes. | Read |
Pagespurebase_list_pages | Pages in a project, or in every project you can see: title, code, parent and a preview. | Read |
Read a pagepurebase_get_page | A 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_page | Make a page in a project, at the top or under another page, optionally with its text. | Read and change |
Edit a pagepurebase_update_page | Replace 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_page | Change a page's title or icon. | Read and change |
Move a pagepurebase_move_page | Move a page, with its sub-pages, under another page or to the top, in its project or another. | Read and change |
PureSpark24
| Tool | What it does | Needs |
|---|---|---|
Fields and viewspurespark_lookup | The 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_leads | Leads, searched, filtered and sorted, a page at a time. | Read |
Lead boardpurespark_lead_board | Leads by status, as the board shows them: each status's count and its first cards. | Read |
Leads by statuspurespark_lead_groups | Leads grouped by status: each status's count and its first rows. | Read |
A leadpurespark_get_lead | One lead with its company, people and activity counts. | Read |
Make a leadpurespark_create_lead | Make a lead with its main contact, and its company by name or slug. | Read and change |
Change a leadpurespark_update_lead | Change 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_note | Add a note to a lead's activity, as you. | Read and change |
Lead activitypurespark_lead_activity | A lead's activity, newest first: notes, status changes, things from other products. | Read |
Lead historypurespark_lead_history | Every change to a lead's fields, newest first. | Read |
Add a person to a leadpurespark_link_person | Add 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_person | Take a person off a lead. The person stays in PureSpark. | Read and change |
List companiespurespark_list_companies | Companies, searched, filtered and sorted, a page at a time. | Read |
A companypurespark_get_company | One company with its people and leads. | Read |
Company historypurespark_company_history | Every change to a company's fields, newest first. | Read |
Make a companypurespark_create_company | Make a company. | Read and change |
Change a companypurespark_update_company | Change a company's name, website, industry, size or custom fields. | Read and change |
List peoplepurespark_list_people | People, searched, filtered and sorted, a page at a time. | Read |
A personpurespark_get_person | One person with their companies and leads. | Read |
Person historypurespark_person_history | Every change to a person's fields, newest first. | Read |
Add a personpurespark_create_person | Add a person, optionally at a company. | Read and change |
Change a personpurespark_update_person | Change a person's name, email, phone or custom fields. | Read and change |
A person's feedbackpurespark_person_feedback | What this person asked for in PurePulse. Needs PurePulse on the token too. | ReadAlso needs PurePulse |
Put a person at a companypurespark_person_add_company | Put a person at a company, with their role there. | Read and change |
PurePulse12
| Tool | What it does | Needs |
|---|---|---|
People and areaspurepulse_lookup | Your role, the areas (with ids), the people (with user ids) and the counts per list and area. | Read |
Where tasks can gopurepulse_task_targets | The PureBase projects a task made from feedback can go to (your Inbox first). Needs PureBase on the token too. | ReadAlso needs PureBase |
Countspurepulse_counts | How many items are in each list (new, all, planned, done) and each area. | Read |
List feedbackpurepulse_list_items | Feedback 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_item | One 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_item | Add feedback someone gave, for example after a call. | Read and change |
Change an itempurepulse_update_item | Change an item's title, status, owner, area, notify-on-done or whether it shows on the public board. | Read and change |
Merge itemspurepulse_merge_items | Merge an item into another: its asks move there and it goes away. | Read and changeDestructive |
Commentspurepulse_list_comments | The team's comments on an item. | Read |
Commentpurepulse_add_comment | Comment on an item, as you. public: true shows it on the public board as a team reply. | Read and change |
Item activitypurepulse_item_activity | What happened to an item. | Read |
Make a PureBase taskpurepulse_make_task | Make 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.