Basic Memory
Teams

Joining a Team Workspace

First-time setup for new team members — accept the invite, sign in, switch workspaces, and connect your AI assistant to the shared knowledge base.

You got an invite to a Basic Memory team workspace. This page walks through what to do on day one — accept the invite, get into the workspace, find the shared projects, and point your AI assistant at the same knowledge base.

You'll need a Basic Memory account on the email address the invite was sent to. If you don't have one yet, the accept flow walks you through creating it.

1. Accept the invitation

Open the invitation email and click the Accept invitation link. It opens an accept page in the app.

  • Sign in with the email the invite was sent to.
  • If you're already signed in with a different account, the app will prompt you to sign in again with the invited email.
  • If this is your first time, you'll create an account during sign-in.

On first sign-in, your account is linked to the pending membership, and you become an active team member.

2. Switch to the team workspace

Open the app at app.basicmemory.com. Use the workspace selector to switch from your personal workspace to the team's organization workspace.

  • Each workspace has its own sidebar, projects, and notes.
  • Switch back to personal anytime — your personal work isn't visible to teammates.

3. Find the shared projects

In the team workspace, the sidebar shows the projects you have access to. Open one to see its folders and notes.

Your role determines what you can do:

RoleYou can
ViewerRead shared projects
EditorRead and write shared projects; create new notes; manage invitations
OwnerEverything an editor can, plus manage members, billing, and project visibility

Not sure of your role? Open Settings → Teams to see it next to your name. If you need a different role, ask an owner.

4. Connect your AI assistant

Your assistant works with the team workspace through the same MCP endpoint as your personal cloud. Pick the path that matches your tool:

  • Claude Desktop / Claude Code — see Claude Desktop or Claude Code. Use the OAuth flow; your assistant will see team projects automatically once you've accepted the invite.
  • ChatGPT — see ChatGPT.
  • Codex / Cursor / VS Code / Obsidian — see the integrations index.
  • CLI — bm cloud login once, then bm project list shows projects across every workspace you can access (personal and team).
With v0.21, your assistant's project list spans every workspace you can reach, so team projects show up without extra configuration. See v0.21.0 for the cross-workspace discovery story.

Targeting the team workspace explicitly

If you want a CLI command or MCP call to act on a team project (and avoid ambiguity with a same-named personal project), be explicit:

# Make the team workspace your default
bm cloud workspace set-default acme

# Or target it per command
bm project list --workspace acme

From MCP, pass the workspace through create_memory_project(workspace="acme") or use a project-prefixed permalink.

5. Get oriented

A few good first steps in any new team workspace:

  • Browse the project tree to see what your team already has.
  • Search a topic you care about — see what's already been written.
  • Pin the projects or notes you'll come back to.
  • Read the team's conventions if they've documented any (look for an onboarding, README, or team-norms note).

Bringing your existing notes with you

Already have personal notes you want to share with the team? Cross-workspace transfer is a copy workflow — see Copy Content Between Workspaces for the project ZIP, single-note, and MCP recipes.

Related

Basic Memory Teams

Share a cloud workspace with your team — invite members, assign roles, and collaborate on the same projects.

Copy Content Between Workspaces

Move notes, folders, or whole projects between personal, team, and local workspaces using export/import or MCP.