Organization and Teams

The organization is the main workspace in Almirant. All projects, members, integrations, and settings belong to an organization. Within the organization, you can manage teams to organize work at a more granular level.

What is an organization

An organization in Almirant represents your company, team, or working group. It is the top-level container that groups:

• Projects -- All projects created belong to an organization.
• Members -- The people who have access to the organization and its projects.
• Integrations -- Connections to external services (GitHub, Vercel, Telegram).
• AI Providers -- The provider and quota configuration for artificial intelligence.
• API Keys -- Access tokens for external integrations and MCP.

Configuring the organization

To access your organization's settings:

1. Click on your organization's name in the sidebar.
2. Select Settings or navigate directly from Settings.

Organization details

Field	Description	Required
Name	Organization name displayed throughout the platform	Yes
Logo	Representative image for the organization	No
Slug	Unique identifier in the organization's URL	Yes

To update the details:

1. Go to Settings > General.
2. Modify the desired fields.
3. Save the changes.

Member management

Members are the people who have access to the organization and can work on its projects.

Inviting members

1. Go to Settings > Members.
2. Click Invite member.
3. Enter the new member's email address.
4. Select the role they will have in the organization.
5. Send the invitation.

The member will receive an email with a link to join the organization. If they already have an Almirant account, they will be added directly. If not, they will need to create an account first.

Member roles

Almirant defines roles to control each member's level of access:

Role	Permissions
Owner	Full control over the organization. Can manage members, settings, billing, and delete the organization
Admin	Can manage members, projects, integrations, and settings. Cannot delete the organization
Member	Can work on assigned projects, create and edit work items, use AI Planning and agents

Principle of least privilege

Assign the most restrictive role that still allows each member to do their job. Reserve the Owner role for 1-2 people and Admin for team leads.

Viewing active members

The members list shows:

• Name and email of each member.
• Assigned role.
• Date joined.
• Invitation status (pending, accepted).

Changing a member's role

1. Go to Settings > Members.
2. Find the member in the list.
3. Click on the role selector.
4. Select the new role.
5. Confirm the change.

Removing a member

1. Go to Settings > Members.
2. Find the member in the list.
3. Click Remove or the removal icon.
4. Confirm the removal.

warning

Removing a member revokes their access immediately. Work items assigned to the member will retain the historical assignment, but the member will no longer receive notifications. Reassign active work items before removing the member.

Teams

Teams allow you to group members within an organization to facilitate work assignment and communication.

Creating a team

1. Go to Settings > Teams.
2. Click Create team.
3. Set a name for the team (for example: "Frontend", "Backend", "QA").
4. Add members to the team by selecting them from the organization's member list.
5. Save the team.

Using teams

Teams are useful for:

• Quick assignment -- Assign work items to an entire team instead of individual members.
• Filtering -- Filter the board by team to see only a specific group's tasks.
• Visibility -- Quickly understand who belongs to each functional area.

Transferring projects between organizations

If you have access to multiple organizations, you can transfer projects from one to another. See the project transfer section for more details.

For Developers

MCP Tools

The following tools are available via MCP for managing members:

Tool	Description	Main parameters
list_members	Lists the organization's members	organizationId

Example: Listing members

Tool: list_members
Parameters:
  organizationId: "organization-uuid"

Returns the list of members with their name, email, role, and status.

Application routes

Route	Description
/settings	General organization settings
/settings/members	Member management
/settings/teams	Team management