home / mcp / repsona mcp server

Repsona MCP Server

Provides task, project, user management and inbox actions via MCP using Repsona API.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "bellx2-repsona-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@bellx2/repsona-mcp-server"
      ],
      "env": {
        "REPSONA_API_KEY": "your_api_key",
        "REPSONA_SPACE_ID": "your_space_id"
      }
    }
  }
}

You run an MCP server that connects Repsona with MCP-compatible clients, enabling task management, project handling, user management, and more through Repsona’s API. It lets you perform actions with MCP clients like Claude Desktop to work with Repsona features directly from your environment.

How to use

After you set up the MCP server, you can issue natural language requests to MCP-enabled clients to manage tasks, projects, notes, and inbox items. Examples include asking for today’s tasks, creating a new task, listing projects, updating a note, checking unread inbox messages, marking the inbox as read, or listing all tags.

How to install

Prerequisites: you need Node.js and npm installed on your system. You will run the MCP server using npx so you don’t need to install the package globally.

Step 1: Create the MCP server configuration file for your client. You can place this JSON configuration where your client expects MCP server settings.

{
  "mcpServers": {
    "repsona": {
      "command": "npx",
      "args": ["-y", "@bellx2/repsona-mcp-server"],
      "env": {
        "REPSONA_SPACE_ID": "your_space_id",
        "REPSONA_API_KEY": "your_api_key"
      }
    }
  }
}

Additional setup notes

Step 2: Run the MCP server using the command snippet from your chosen environment. The configuration above uses npx to start the server with the specified environment variables.

Available tools

get_tasks

Retrieve the list of tasks for a specified project.

get_task

Fetch details for a specific task.

create_task

Create a new task in a project.

update_task

Update an existing task.

delete_task

Delete a task.

get_task_subtasks

List subtasks for a task.

get_task_comments

List comments on a task.

create_task_comment

Post a new comment on a task.

update_task_comment

Update a task comment.

delete_task_comment

Delete a task comment.

get_task_activity_log

Get the activity log for a task.

get_task_history

Get the history of a task.

get_project_notes

List notes within a project.

get_project_note

Fetch details of a project note.

create_project_note

Create a new project note.

update_project_note

Update a project note.

delete_project_note

Delete a project note.

get_project_note_children

List child notes of a project note.

get_project_note_comments

List comments on a project note.

create_project_note_comment

Post a comment on a project note.

update_project_note_comment

Update a project note comment.

delete_project_note_comment

Delete a project note comment.

get_project_note_activity_log

Get the activity log for a project note.

get_project_note_history

Get the history of a project note.

download_file

Download a file.

upload_file

Upload a file.

attach_file

Attach a file to a task, comment, or note.

detach_file

Detach a file from a task, comment, or note.

delete_file

Delete a file.

get_me

Retrieve information about the current user.

update_me

Update information for the current user.

get_my_tasks

Get tasks of a specified type for the current user.

get_my_tasks_count

Get the count of tasks of a specified type for the current user.

get_my_projects

List projects the current user participates in.

get_feed

Fetch the current user’s activity feed.

update_user_role

Update a user’s role in a project.

get_projects

List projects the user participates in.

get_project

Get detailed information about a project.

create_project

Create a new project.

update_project

Update project details.

get_project_users

List users participating in a project.

get_project_activity

Retrieve project activity.

get_project_statuses

List project statuses.

get_project_milestones

List project milestones.

get_space_info

Get information about the workspace space.

invite_to_space

Invite a new member to the space.

get_all_tags

List all tags in the workspace.

get_inbox

Retrieve the current user’s inbox.

update_inbox

Update inbox read/unread status.

archive_all_inbox

Mark all inbox items as read.

get_inbox_unread_count

Get the number of unread inbox items.