# Karea MCP

> Karea MCP is a free MCP server for productivity. Task manager MCP server so coding agents can create, update and close your tasks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, CLI
- **Website:** https://karea.app
- **Repository:** https://github.com/starecz/karea-mcp
- **MCP Registry name:** io.github.starecz/karea-mcp
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

Karea MCP lets Claude Code, Cursor and other clients work directly on a Karea task list while they code. Instead of 70 separate tools, it registers 9 tools that each take an `action`, which keeps the tool list short for the model.

Tasks can carry long markdown notes, open questions, attached resources and a private AI context that later sessions read first, so work resumes where the last session stopped. Tasks can also be linked to Jira, grouped into projects and categories, and summarised in a recap over a date range.

You need a Karea account and an API key from the dashboard settings; the server runs locally over stdio through `npx karea-mcp`.

## Features

- **Nine grouped tools:** Nine tools cover 70 actions, called with an action name and params.
- **Session memory on tasks:** Notes and an AI context entry stay on the task for the next session.
- **Open questions:** Track questions per task and answer them later.
- **Jira linking:** Link Karea tasks to Jira and back.
- **Activity recaps:** Generate a productivity recap across a date range.
- **Meetings and projects:** Create meetings, projects, categories and share projects.

## Good for

- Log what a coding session tried and decided on the task
- Close finished tasks from inside Claude Code
- Keep design notes in task markdown
- Resume work from the task the next day
- Produce a weekly recap of finished work

## Install

### Claude Code (Terminal)

```sh
claude mcp add karea-mcp --env KAREA_API_KEY='<KAREA_API_KEY>' -- npx -y karea-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "karea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "karea-mcp"
      ],
      "env": {
        "KAREA_API_KEY": "<KAREA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "karea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "karea-mcp"
      ],
      "env": {
        "KAREA_API_KEY": "<KAREA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "karea-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "karea-mcp"
      ],
      "env": {
        "KAREA_API_KEY": "<KAREA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "karea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "karea-mcp"
      ],
      "env": {
        "KAREA_API_KEY": "<KAREA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "karea-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "karea-mcp"
      ],
      "env": {
        "KAREA_API_KEY": "<KAREA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `karea_read`: Reads projects, tasks, notes, questions, resources, meetings, sessions and recaps without changing anything.
- `karea_tasks_write`: Creates, edits and closes tasks and subtasks, with closing requisites.
- `karea_notes_write`: Adds or edits task notes and sticky notes and writes the task markdown and AI context.
- `karea_projects_write`: Creates projects and categories and shares a project.
- `karea_meetings_write`: Creates and edits meetings and links tasks and questions to them.

## FAQ

### How do I install it?

Run `npx karea-mcp` and set `KAREA_API_KEY`; `KAREA_URL` defaults to https://karea.app.

### Can I get every action as its own tool?

Yes, set `KAREA_MCP_LEGACY_TOOLS=1` to register all 70 actions individually.

### What does Karea cost?

The pricing page says Karea is free for individuals with an AI monthly allowance; Enterprise is priced per organisation.

### Is Karea MCP free?

Yes. Karea MCP is free to use.

### How do I add Karea MCP to Claude Code?

Run this command in your terminal: claude mcp add karea-mcp --env KAREA_API_KEY='<KAREA_API_KEY>' -- npx -y karea-mcp

### What are the best alternatives to Karea MCP?

The closest alternatives to Karea MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/karea-mcp
