Skip to main content
Already exposes 10 tools via the Model Context Protocol (MCP). Any MCP-compatible AI client (Claude Desktop, Cursor, Windsurf, etc.) can connect and manage sessions, comments, and notes.

​
Connection

Connect using the streamable HTTP transport. 
https://already.so/mcp-server
Configure your MCP client to connect to this URL with the authentication headers below.

​
Authentication

Two authentication methods are supported.

​
Personal API key (PAK)

Generated in your account settings. Scoped to your user identity. 
Authorization: Bearer pak_xxxxxxxxxxxxx
X-Team-Id: <team-uuid>

​
Agent API key

Each registered agent has a unique key. Scoped to the agent’s team. 
Authorization: Bearer ak_xxxxxxxxxxxxx
X-Team-Id: <team-uuid>

​
Configuration example

Add this to ~/.claude.json or your project’s .claude.json to connect Claude Code: 
{
  "mcpServers": {
    "already": {
      "type": "sse",
      "url": "https://already.so/mcp-server",
      "headers": {
        "Authorization": "Bearer <your-pak-or-api-key>",
        "X-Team-Id": "<your-team-uuid>"
      }
    }
  }
}
Replace the key and team ID with values from your Already account settings.

​
Available tools

Already provides 10 MCP tools across three categories:
CategoryTools
Sessionsalready_list_sessions, already_get_session, already_create_session, already_update_session, already_delete_session, already_get_assigned
Commentsalready_get_comments, already_add_comment
Notesalready_get_notes, already_update_notes
See the tools reference for parameters and return types.