# Peerbie MCP > Peerbie MCP Server connects your AI agent to your entire workspace. It lets you manage projects, track tasks, list team members, and read company announcements—all through natural conversation. Instead of opening dashboards, tell your agent what needs doing and get the status immediately. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** digital-workspace, task-management, team-collaboration, workflow-automation, calendar-events ## Description **Peerbie MCP Server** connects your agent straight into every corner of your Peerbie workspace. You don't gotta open dashboards or click through menus just to get answers; you talk to your agent, and it handles all the cross-project logic for you. It makes talking about work feel like using a natural language project manager. **Managing Projects and Tasks** * To start something new, you can use **`create_project`** to build an entire container within your workspace; if you need details on an existing job, call **`get_project`** with the specific ID. You'll never lose sight of what's going on because the agent can list every project in your account using **`list_projects`**. For tasks, it works just as hard: use **`create_task`** to generate and assign a new item under a project, or call **`get_task`** when you need the full scoop on one specific task ID. It'll give you a complete roster of everything using **`list_tasks`**, or narrow it down by just checking tasks for one targeted project with **`list_tasks_by_project`**. Need to change something? You use **`update_task`** to modify details like status or who owns it, keeping records current without making a mess of new entries. **Querying Team and Organizational Data** * The agent reads out all the setup info you need: run **`list_teams`** to see every defined team group, then use **`get_team`** for detailed information on a specific structure. When it comes to people, **`list_members`** gives you a roster of everyone in your workspace, including their roles and direct contact info; you can also check out the full internal directory using **`get_team`**. For channels, **`list_channels`** shows all available communication streams within the entire workspace. **Coordinating Communications and Feeds** * Need to make an official announcement for everyone? Use **`create_post`** to publish a new company-wide update straight to the main feed. To catch up on what's been happening, you can pull the most recent activity posts from the main channel using **`list_feed`**. **Tracking Schedules and Events** * The agent pulls upcoming dates for your whole team or filters by specific criteria when you call **`list_events`**, keeping everyone synced on what's coming up. **Utility and Status Checks** * You can always verify the connection status to make sure everything's working right by calling **`check_peerbie_status`**. This server lets your agent manage project lifecycles, coordinate announcements, pull team directories, and track events—all without you ever leaving a natural conversation flow. ## Tools ### check_peerbie_status Verifies the live connection and connectivity status with your Peerbie account. ### create_post Publishes a new, company-wide announcement or update to the main feed. ### create_project Creates an entirely new project container within the workspace. ### create_task Generates and assigns a specific task under an existing project. ### get_project Retrieves all current details for a single, specified project ID. ### get_task Fetches the full details of one specific task using its unique identifier. ### get_team Retrieves detailed information about an entire team structure. ### list_channels Lists all available communication channels within your workspace. ### list_events Returns a list of upcoming scheduled calendar events for the workspace members. ### list_feed Retrieves the most recent activity posts from the company's main feed. ### list_members Lists all users in your workspace, including their roles and direct contact info. ### list_projects Returns a list of every project currently managed in your account. ### list_tasks_by_project Lists only the tasks belonging to one specific, targeted project ID. ### list_tasks Retrieves a comprehensive list of every task across all projects. ### list_teams Returns a catalog of all defined team groups in your organization. ### update_task Modifies existing task details—like status or assignee—without creating a new record. ## Prompt Examples **Prompt:** ``` Show all tasks assigned to me in Peerbie ``` **Response:** ``` I've fetched your tasks. You currently have 3 pending tasks across all projects. The highest priority is 'Update marketing materials'. Would you like more details on it? ``` **Prompt:** ``` Create a task 'Review Q4 report' in the Marketing project ``` **Response:** ``` The task 'Review Q4 report' has been successfully created in the Marketing project. I've left it unassigned. Is there anyone specific you'd like me to assign it to? ``` **Prompt:** ``` List upcoming calendar events for the team ``` **Response:** ``` Here are the upcoming events for your team: You have the 'Weekly Standup' tomorrow at 10 AM, and 'Product Review' on Friday at 2 PM. ``` ## Capabilities ### Manage Projects and Tasks The agent creates, retrieves, lists, and updates all project structures and individual tasks based on your request. ### Coordinate Team Communications You can publish official announcements to the company feed or retrieve a list of recent activity posts from the main channel. ### Query Team and Project Data The agent accesses detailed information about team structures, individual members, and specific projects using dedicated getter tools. ### Track Schedules and Events It pulls upcoming dates from the calendar, listing events for your whole team or filtering by specific criteria. ## Use Cases ### The Weekly Status Check A PM needs to update stakeholders. Instead of logging into 5 different project boards, they prompt their agent: 'List all tasks in Project Alpha that are overdue and assign them to John.' The agent uses `list_tasks_by_project` (filtered by status) and then runs `update_task`, solving the problem in one go. ### Onboarding a New Hire HR needs quick details on new team members. They ask: 'Show me all active teams and who belongs to them.' The agent calls `list_teams` then uses `get_team` multiple times, giving HR the full directory from one chat window. ### Immediate Crisis Announcement The CEO needs to broadcast a policy change immediately. They tell their agent: 'Post an urgent update about the Q3 policy change.' The agent runs `create_post`, ensuring the announcement hits the company feed instantly. ### Planning a Cross-Team Meeting A lead needs to schedule a meeting that involves three different teams. They ask: 'List all members in Team X and Team Y who are available next Tuesday.' The agent runs `list_members` for both groups, cross-referencing availability via `list_events`. ## Benefits - Stop manually compiling status reports. Your agent can combine `list_tasks` with `get_project` to summarize cross-project bottlenecks instantly. - Keep your company announcements centralized. Use `create_post` to publish updates directly to the feed, ensuring every team member sees it without needing a reminder email. - Never waste time searching for names or roles again. The agent uses `list_members` to give you immediate access to the full directory and associated roles. - Handle task updates on the fly. Instead of opening the board, just tell your agent to update a status using `update_task`, referencing the specific task ID. - Get an instant view of team capacity by calling `list_events`—you know exactly who is free for a meeting next week. ## How It Works The bottom line is that once connected, your agent treats Peerbie like a native interface, executing actions without you ever needing to see a dashboard. 1. Log in to your Peerbie workspace. 2. Request an API Key within Settings > Integrations. 3. Connect the key to your AI agent via Vinkius. Your agent now has full read/write access to manage projects and tasks. ## Frequently Asked Questions **How do I list all tasks in Peerbie using the `list_tasks` tool?** You ask your agent to run `list_tasks`. This retrieves every task across your entire workspace. If you only want tasks for a specific project, use `list_tasks_by_project` and provide the Project ID instead. **Can I update a task's status with the `update_task` tool?** Yes. You must tell your agent to run `update_task`, providing the unique Task ID, the new status, and any other field you want changed (like assignee). It modifies the record directly. **Where can I find the team directory using `list_members`?** The agent uses `list_members` to pull a complete roster of every user. This includes their roles, letting you know who has authority or skills in different areas without checking individual profiles. **Is there a way to see upcoming meetings with `list_events`?** Yes, the agent runs `list_events`. You can ask it to filter these events by team name or date range to get a quick view of everyone's schedule. **How do I check if a project exists or create one using the `create_project` tool?** You should call `get_project` first to verify the Project ID. If that returns a 404 error, then you can safely use `create_project`. This prevents accidental duplication and ensures your agent has the correct parent context. **What details do I need to use the `create_post` tool for a company announcement?** The tool requires at minimum a title and body content. You can optionally specify which channel or team the post targets, allowing you to narrow down who sees the update immediately. **If I only want to see tasks for a specific area, how do I use `list_tasks_by_project`?** You must provide the unique Project ID as an input parameter. This scope filter limits the results to only those tasks associated with that project, ignoring everything else in your workspace. **How do I confirm that the Peerbie connection is working before running complex commands using `check_peerbie_status`?** Running `check_peerbie_status` confirms live connectivity with Peerbie's API. A successful response means your agent has the necessary permissions and access to start manipulating data. **What collaboration features are available?** Full project and task management with Kanban boards, company-wide feed for announcements, team and channel organization, calendar events, and a complete member directory. **Can I publish announcements to the feed?** Yes, you can directly create and publish company-wide announcements or updates to the team feed via the MCP. **Are calendar events supported?** Absolutely. You can retrieve upcoming calendar events to keep your AI assistant informed of your daily schedule.