Skip to main content
Atlas logoAtlas
Log inStart your workspace

Atlas MCP

Development beta

Bring your Atlas workspace into your AI client.

Connect a compatible AI client to the notes, sources, links, and maps in one Atlas project through the open Model Context Protocol. Atlas provides a remote MCP server—not a marketplace plugin or browser extension.

Set up Atlas MCPSee the 13 tools

What you can do

Keep research and action in the same context.

01

Understand your workspace

Read notes, sources, folders, and maps without copying research into another tool.

02

Find the right evidence

Search your Atlas project, the web, and academic literature from the same conversation.

03

Build connected knowledge

Create and refine notes, add sources, and link related ideas with stable Atlas IDs.

04

Work with visual maps

Inspect and edit the knowledge maps that organize relationships across a project.

Installation

Connect with the client you already use.

Every connection is scoped to one project URL and authenticated with your Atlas account.

Codex · Claude Code · Claude.ai · Other MCP clients

Register Atlas as a remote Streamable HTTP server, then complete the OAuth login in your browser. The public /mcp page is documentation, not the server URL.

codex mcp add atlas --url https://www.atlasworkspace.ai/api/mcp/<project-uuid> --oauth-resource https://www.atlasworkspace.ai/api/mcp
codex mcp login atlas

  1. Choose a project

    Replace <project-uuid> with the UUID from an Atlas project you own.

  2. Connect and sign in

    Run both commands and approve the Atlas OAuth request in your browser.

  3. Verify Atlas

    Ask Codex to list the available Atlas tools, then begin with List or Read.

Add the project-scoped HTTP endpoint, then use Claude Code's MCP menu to authenticate when prompted.

claude mcp add --transport http atlas https://www.atlasworkspace.ai/api/mcp/<project-uuid>

  1. Choose a project

    Replace <project-uuid> with the UUID from an Atlas project you own.

  2. Connect and sign in

    Run the command, open /mcp, and complete Atlas OAuth.

  3. Verify Atlas

    Confirm Atlas is connected and that its 13 tools are available.

Claude.ai clients with custom remote MCP support can connect directly to the Atlas project endpoint.

https://www.atlasworkspace.ai/api/mcp/<project-uuid>

  1. Choose a project

    Replace <project-uuid> with the UUID from an Atlas project you own.

  2. Add the server

    In Settings, open Connectors and add a custom remote MCP server using the endpoint above.

  3. Authenticate

    Complete Atlas OAuth, then confirm the Atlas tools appear in a conversation.

Use any client that supports remote MCP over Streamable HTTP and OAuth 2.1.

https://www.atlasworkspace.ai/api/mcp/<project-uuid>

  1. Choose a project

    Replace <project-uuid> with the UUID from an Atlas project you own.

  2. Add Atlas

    Create a remote HTTP MCP connection named Atlas and paste the endpoint.

  3. Authenticate

    Complete OAuth discovery and sign in with your Atlas account. Client support for deletion confirmation may vary.

11 project tools

The same Atlas actions, through MCP.

Tool names and behavior stay aligned with the Atlas research agent. Start with Read before Edit and reuse the stable UUIDs returned by Atlas.

Read and understand

Inspect project content, navigate folders, search, and understand maps.

  • Read
  • List
  • Search
  • ReadMap
  • Help

Create and connect

Add notes, PDF highlights, and sources, then connect related items in your workspace.

  • Write
  • Highlight
  • AddSource
  • Link

Refine and manage

Update existing knowledge and confirm permanent deletion when supported.

  • Edit
  • EditMap
  • Delete

FAQ

Before you connect.

What is Atlas MCP?

Atlas MCP is a project-scoped remote server that lets compatible AI clients use Atlas tools through the open Model Context Protocol.

Is this a plugin or browser extension?

No. Atlas connects directly through a remote MCP endpoint and OAuth. There is no marketplace plugin, browser extension, or separate package to install.

Which Atlas project can the client access?

Only the project UUID in the connection URL. Atlas verifies that the signed-in account owns that project, and existing row-level security remains in force.

Who can access the development beta?

Atlas MCP is active as a limited development beta for approved accounts. Atlas may temporarily disable the server if pilot monitoring finds an authentication or compatibility issue.

Can an AI client permanently delete Atlas content?

Only after the client presents a confirmation that identifies the Atlas item. Clients without MCP elicitation support cannot use Delete.