# atlas-mcp-server

> MCP Server

ATLAS is a task management system for LLM Agents, built on a three-tier architecture, that allows users to manage projects, tasks, and knowledge with defined schemas and completion requirements.

## Overview

- **Category:** Productivity
- **Language:** TypeScript
- **Stars:** 476
- **Forks:** 18
- **Owner:** cyanheads
- **GitHub:** https://github.com/cyanheads/atlas-mcp-server
- **Homepage:** https://www.npmjs.com/package/atlas-mcp-server
- **Created:** 2024-12-16T05:55:30+00:00
- **Updated:** 2025-03-28T10:01:58+00:00
- **Source:** https://model-context-protocol.com/servers/llm-agent-task-management-neo4j-server

## Setup

## Setup

1. Clone the repository:

```bash
git clone https://github.com/cyanheads/atlas-mcp-server.git
cd atlas-mcp-server
```

2. Install dependencies:

```bash
npm install
```

3. Configure Neo4j:

```bash
# Start Neo4j using Docker
docker-compose up -d
```

4. Build the project:

```bash
npm run build
```

### Environment Variables

Create a `.env` file based on `.env.example`:

```bash
# Neo4j Configuration
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=password2

# Application Configuration
LOG_LEVEL=info # debug, info, warn, error
NODE_ENV=development # development, production
```

### MCP Client Settings

Add to your MCP client settings:

```json
{
  "mcpServers": {
    "atlas": {
      "command": "node",
      "args": ["/path/to/atlas-mcp-server/dist/index.js"],
      "env": {
        "NEO4J_URI": "bolt://localhost:7687",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "password2",
        "LOG_LEVEL": "info",
        "NODE_ENV": "production"
      }
    }
  }
}
```

## Tools

## Available Tools

1.  Project Management (Manage project metadata, statuses, and rich content with built-in support for bulk operations).
2.  Task Management (Create, track, and update tasks through their entire lifecycle).
3.  Knowledge Management (Maintain a searchable repository of project-related information).
4.  Graph Database Integration (Leverage Neo4j's ACID-compliant transactions and optimized queries for robust data integrity).
5.  Unified Search (Find relevant projects, tasks, or knowledge based on content, metadata, or relationships).
6.  `atlas_project_create` (Creates new projects, single or bulk).
7.  `atlas_project_list` (Lists projects, all or details for one).
8.  `atlas_project_update` (Updates existing projects, single or bulk).
9.  `atlas_project_delete` (Deletes projects, single or bulk).
10. `atlas_task_create` (Creates new tasks, single or bulk, associated with a project).
11. `atlas_task_update` (Updates existing tasks, single or bulk).
12. `atlas_task_delete` (Deletes tasks, single or bulk).
13. `atlas_task_list` (Lists tasks for a specific project).
14. `atlas_knowledge_add` (Adds new knowledge items, single or bulk, associated with a project).
15. `atlas_knowledge_delete` (Deletes knowledge items, single or bulk).
16. `atlas_knowledge_list` (Lists knowledge items for a specific project).
17. `atlas_unified_search` (Performs a unified search across projects, tasks, and knowledge).
18. `atlas_database_clean` (Completely resets the database, removing all projects, tasks, and knowledge).