---
title: "What the Talkspirit MCP server can do"
description: "What an AI assistant connected through the Talkspirit MCP server can read, search, create, change and remove, the rules that apply to all of it, and where the content it reads goes."
category: integrations
section: api-and-webhooks
tags: [ai]
type: Reference
lastUpdated: 2026-11-13
locale: en
canonical: https://support.talkspirit.com/en/integrations/what-the-mcp-server-can-do
---

# What the Talkspirit MCP server can do


The Talkspirit MCP server lets an AI assistant such as Claude work in your organisation for you. The assistant reads circles, roles, tasks, meetings, goals, metrics and posts, and creates or changes a defined set of items. It acts as you, with your own permissions. It removes almost nothing, and it never changes a circle or a role directly.

To connect an assistant first, follow [Connecting Claude and other AI assistants to Talkspirit](/en/integrations/connect-claude-and-other-ai-assistants).

## Which rules apply to everything the assistant does?

- **It acts as you.** It uses your own identity, through your MCP key or your sign-in. Talkspirit applies the same permission rules as to your own actions, so the assistant can do what those rules allow even where a screen does not offer it.
- **Its changes carry your name.** A task it creates or a comment it writes appears as yours, and nothing marks it as made by the assistant.
- **Your key decides whether it can write.** A **Read only** key lets it read, search and count, and hides its write tool. Anything else needs a **Read and write** key, or a sign-in that granted write access. If an administrator sets the organisation's MCP access to **Read-only**, no key can write.
- **One request can change up to 100 items of the same kind.** Talkspirit checks and applies each item in turn.
- **Guests can do less.** Guests cannot create boards, goals, meetings or agenda items, and some guests cannot read circles and roles.
- **Administrators set the level of access for the whole organisation.** Under **Administration → Security → MCP keys**, an administrator selects **MCP access** and chooses **Enabled**, **Read-only** or **Disabled**. The level applies to personal keys and to sign-in connections such as Claude and ChatGPT, and it is **Enabled** by default. **Read-only** refuses the write tools and stops offering them, even to a key that can write. Those keys write again when access returns to **Enabled**. **Disabled** refuses every request and blocks new keys, and existing keys work again once access is back. The in-app assistant is not affected.
- **Administrators can see and revoke members' personal keys.** The **Personal MCP keys** screen lists every active key with its owner, creation date, last use and expiry. **Revoke** ends a key at once and cannot be undone, and its owner can create a new one. Sign-in connections are cut by setting access to **Disabled**. Each member still deletes their own keys under **My Account → MCP keys**. Switching Spark off does not disconnect the MCP server.

> **Note:** a change to several items is not all or nothing. If one item fails, the items already changed stay changed and the next items are still tried, and a long request can stop early. Ask the assistant which items failed or were not tried before you retry.

## What can the assistant read?

The assistant reads the items below, with the fields, filters and sorting it asks for. It gets only what Talkspirit lets you see. Some items are visible to every member: tensions, circle checklists and their comments, time allocations, and who holds each role.

| Area | What the assistant reads |
| --- | --- |
| Structure and governance | Circles, roles, who holds each role and who belongs to each circle, time allocations, tensions, proposals, working agreements such as policies and procedures, circle checklists, and the comments on proposals, working agreements and checklists |
| Projects | Boards with their sections and labels, tasks with their subtask groups and the files and links attached to them, and the comments on tasks and boards |
| Meetings | Meetings with their participants, reports, transcripts and action items, and your own agenda items |
| Goals and metrics | Goals, key results with the tasks and projects linked to them, metrics, the files and links attached to a goal or a metric, and the comments on them |
| Newsfeed | Posts |
| Members | Names |

Four limits apply to reading:

- **Agenda items are yours only.** The assistant lists the agenda items you created or present, in any meeting or your parking lot, never a meeting's full agenda. An empty list means you have no items there.
- **Contact details stay out.** The assistant reads members' names, never their email addresses or phone numbers, unless someone typed them into a text.
- **Only a task's attached files come with a download link.** For each file attached to a task, the assistant gets its name, type and size, and a temporary link that downloads the file without signing in. For a file attached to a goal or a metric it gets the name, type and size, and no download link. For an attached link, wherever it hangs, it gets the link's title and its address.
- **Some lists stop at one page.** Proposals, tensions and working agreements come back 50 at a time and members 100 at a time, with no next page. Ask for a narrower list, for example one circle.

## Which searches and analyses can it run?

- **Search the Knowledge Base.** When your organisation has the Knowledge Base enabled, the assistant searches it: the documents added to it, roles and circles, and each source an administrator switched on, such as decided proposals, published meeting reports, goals and working agreements. An empty result means nothing matched, the Knowledge Base is off, or the search failed.
- **Count and compare.** The assistant counts items such as tasks, meetings, goals and comments, broken down by a field such as status where the item allows it. It also compares groups side by side, for example the tasks in progress on two boards.

## What can the assistant create and change?

Every action below needs write access.

| Area | What the assistant can do |
| --- | --- |
| Tasks | Create a task or a subtask with its assignees. Change its title, description, board, section, priority, dates, privacy and status (**To Do**, **In Progress**, **Done**, **Blocked**); moving a task to another board removes its labels. Create and update subtask groups. Assign a member, role, circle or group to a task. Create a label on a board and put it on a task. Attach a file that is already in Talkspirit to a task |
| Boards | Create a board, which you own and which is private unless you choose another privacy. Change its name, description and privacy. Add a member, role, circle or group with a board role. Add a section |
| Goals | Create and change goals, including their category, owner, parent goal, privacy, health status, time periods and progress. Create and change key results, including their current value and progress |
| Metrics | Define a metric owned by a circle or a role, and edit it. Record a value for a period on a circle's or a role's metric, which any member can do. Recording again for the same period replaces the value |
| Meetings | Create a meeting, as a draft unless you ask for it to be scheduled; in a circle, it invites the circle's members. Change a meeting you can edit, including its status, for example to cancel it; a cancelled meeting cannot change again. Create a recurring meeting with you as its only participant. Add an agenda item to a meeting you can add items to, or to your parking lot |
| Governance | Raise a tension and edit the tensions you wrote. Create and edit circle checklists, and tick or untick a checklist for its current period. Add a custom field to circles or roles, if you are an administrator |
| Comments | Comment on a task, board, goal, key result or metric, and reply to a comment. Edit a comment you wrote, or any comment on a board you manage |
| Files | Attach a file that is already in Talkspirit to a goal, a metric or a proposal you can change, to an agenda item or a working agreement you can edit, or to a checklist you can manage. Attaching the same file again changes nothing |
| Links | Attach a link, such as a shared document or a recording, to an agenda item you can edit or to a circle's checklist |

> **Note:** the text it writes keeps its formatting. Titles, lists, bold, italic, code and links the assistant writes in a description or a comment come out as formatting rather than as the characters it typed. A comment is laid out in plain paragraphs, so a title in one reads as a bold line and a list item as a bullet.

## What can the assistant remove?

The assistant removes only a few things: an assignee from a task (the task itself stays), a label from a task, a link you added from an agenda item or a checklist, and a file from a task, a goal, a metric or a proposal (the file itself stays in Talkspirit). It does not detach a file from an agenda item, a checklist or a working agreement: remove it in Talkspirit. It deletes no task, board, goal, key result, meeting, metric, label, comment, tension or proposal.

## What can the assistant not do?

- Create, change, move or delete a circle or a role.
- Read or send chat messages.
- Publish a post, or edit a working agreement.
- Delete or archive a task, board, goal, meeting or metric.
- Invite or deactivate members, change who holds a role, or remove a member from a board.
- Change organisation or module settings, apart from adding a custom field.
- Process a tension, or submit a proposal.
- Answer a meeting invitation, change an agenda item once added, or change a whole recurring series. It can still change or cancel a single meeting of the series.

## Where does the content it reads go?

Content the assistant reads through the MCP server leaves Talkspirit. It goes to the assistant you connected, and that assistant's provider processes it, for example Anthropic for Claude, under the terms you or your company accepted with that provider. This includes the download links of files attached to tasks.

Talkspirit also keeps its own records:

- **Each call is logged:** which tool, the result, how long it took, and which member and organisation made it.

For everything the connector stores and for how long, see the [MCP connector privacy policy](/en/integrations/mcp-connector-privacy-policy).

## Next steps

- [Connecting Claude and other AI assistants to Talkspirit](/en/integrations/connect-claude-and-other-ai-assistants)
- [Create and manage MCP keys](/en/integrations/create-and-manage-mcp-keys)
- [Enabling the Knowledge Base for Spark](/en/administration-security/enabling-the-knowledge-base-for-spark)
- [How Spark processes your organisation's data](/en/administration-security/how-ai-processes-your-data)
