Connect it
You need a server address. On the hosted version it is https://api.jinear.co/mcp. On your own server it is your API domain with /mcp on the end, and every member finds it in their profile with a copy button.
In Claude
- Open Settings, then Connectors.
- Choose Add custom connector and paste the address.
- Sign in to Jinear when it asks, then allow the permissions you want to give.
In ChatGPT
- Turn on Developer Mode in Settings.
- Add a connector and paste the same address.
- Sign in and allow, exactly as above.
Self-hosting? Your instance has to be reachable from the internet over HTTPS, because those assistants connect from their own servers rather than from your browser. The setup guide covers the configuration, and the proxy to use when your instance is on a private network.
What it can do
27 tools, 20 of them read only. Permissions are per resource and split between reading and writing, so allowing task writes does not hand over your calendar.
- There are no delete tools. An assistant cannot remove a task, a note or a file.
- Notes and the calendar are read only. A note body is a collaborative document owned by the editor, and a calendar write would mean writing to Google on your behalf.
- Every tool works inside one workspace, checked against your account on every call.
- You can disconnect at any time, from your profile. It takes effect on the next call, not when a token expires.
Every tool
Grouped by the permission it asks for. This list shows the hosted version. A self-hosted server can run a different version; it lists its exact tools at your API domain with /v1/mcp/manifest on the end.
Workspaces workspace:read
Workspaces, teams, members, topics and workflow statuses.
fetchread only- Reads the full text of one record previously returned by search, given its id. Returns the title, the body as text, and a link a person can open.
get_workspaceread only- Reads one workspace by its id or by its short username handle. Use it to resolve a workspace a person named in conversation into a workspaceId.
list_teamsread only- Lists the teams inside a workspace. Tasks and boards belong to a team, so a teamId from here is needed before creating a task or reading a team's board.
list_topicsread only- Lists the topics a team uses to label its tasks. Read this to turn a label a person named into the topicId create_task takes.
list_workflow_statusesread only- Lists the workflow statuses a team's tasks can be in, such as Backlog, In Progress or Done. Statuses are defined per team and referenced by id, so read this before calling set_task_status.
list_workspace_membersread only- Lists the people in a workspace with their account ids. Use it to turn a person's name into the accountId that create_task and update_task take as an assignee.
list_workspacesread only- Lists every Jinear workspace the signed in account belongs to, with the account's role in each. Call this first: workspaceId is required by almost every other Jinear tool.
searchread only- Searches tasks and note titles across every Jinear workspace the signed in account belongs to, and returns ids and links suitable for citation. Pass an id from here to fetch to read the full record. Tasks created or edited in the last minute may not appear yet; use list_tasks to see them. For filtering by status, assignee or dates, use list_tasks instead.
Read tasks tasks:read
Tasks, boards and comments.
fetchread only- Reads the full text of one record previously returned by search, given its id. Returns the title, the body as text, and a link a person can open.
get_taskread only- Reads a single task in full, including its body, by its human readable reference such as ENG-42. Use it after search_tasks or list_tasks when the body of a specific task is needed.
list_task_attachmentsread only- Lists the files attached to a task, oldest first. Each item carries a downloadUrl for the person to click. Opening it uses the reader's own Jinear session, so it works in a browser signed in to an account that can see the task. It does not return the files' contents.
list_task_boardsread only- Lists the boards belonging to a team, newest first. A board groups tasks for a sprint, a release or any other batch of work.
list_task_commentsread only- Reads the discussion on a task, oldest first, 25 comments per page. On a long thread, read the last page (totalPages - 1) for the latest comments. Use it to catch up on what has already been said before answering or adding a comment.
list_tasksread only- Lists tasks in a workspace, optionally narrowed by team, assignee, workflow status, state group or a date range. This is the tool for questions like what is in progress, what is assigned to someone, or what is due this week.
searchread only- Searches tasks and note titles across every Jinear workspace the signed in account belongs to, and returns ids and links suitable for citation. Pass an id from here to fetch to read the full record. Tasks created or edited in the last minute may not appear yet; use list_tasks to see them. For filtering by status, assignee or dates, use list_tasks instead.
search_tasksread only- Finds tasks in a workspace whose title or body matches a plain language query. Use this when the person names a task by what it is about rather than by its reference. Tasks created or edited in the last minute may not appear yet; use list_tasks to see them. Use list_tasks instead when filtering by status, assignee or dates.
Write tasks tasks:write
Creating and updating tasks, boards and comments.
add_task_attachment- Attaches a new file to a task, attributed to the signed in account. Pass the content as text for text files such as Markdown, CSV or JSON, or as contentBase64 for binary files such as images or PDFs. Needs a PRO workspace with free storage. Returns the new attachment's id and a downloadUrl for the person.
add_task_comment- Adds a comment to a task, attributed to the signed in account. Use it to record a decision, an update or an answer where the work lives. Returns the new comment's id.
add_task_to_board- Puts an existing task onto a board. The task keeps its team, status and assignee; only its board membership changes.
create_task- Creates a task in a team. Only workspaceId, teamId and title are required. Give it a due date to put it on the calendar, and an assignee account id to hand it to someone. Returns the created task, including its reference such as ENG-42.
create_task_board- Creates an empty board in a team. Add tasks to it afterwards with add_task_to_board.
set_task_status- Moves a task into one of its team's workflow statuses, for example from In Progress to Done. Statuses are per team and referenced by id, so call list_workflow_statuses for the task's team first. Jinear does not delete tasks; retiring one means moving it to a status in the CANCELLED group.
update_task- Changes a task's title, body, dates or assignee. Supply only the fields to change; anything omitted is left alone. Dates are the one exception: Jinear stores start and due as a pair, so supply both together. Use set_task_status to move a task between workflow statuses.
Read calendar calendar:read
Calendar events, including any synced from Google Calendar.
list_calendar_eventsread only- Lists everything on a workspace's calendar between two instants: tasks that carry dates and events synced from an attached Google Calendar. Use it to answer what is happening this week or when someone is busy.
Read notes notes:read
Notebooks and notes.
fetchread only- Reads the full text of one record previously returned by search, given its id. Returns the title, the body as text, and a link a person can open.
get_noteread only- Reads a single note in full, including its body. Use it after search_notes when the contents of a specific note are needed.
list_notebooksread only- Lists the notebooks in a workspace. A notebook groups related notes, and its id is what narrows search_notes to one place.
searchread only- Searches tasks and note titles across every Jinear workspace the signed in account belongs to, and returns ids and links suitable for citation. Pass an id from here to fetch to read the full record. Tasks created or edited in the last minute may not appear yet; use list_tasks to see them. For filtering by status, assignee or dates, use list_tasks instead.
search_notesread only- Lists notes in a workspace, optionally inside one notebook or under one parent note, and optionally narrowed to titles containing a phrase. Returns titles and ids; call get_note for a note's body.
Read files files:read
Files, folders and links to them.
get_file_linkread only- Returns the Jinear download link for a stored file, suitable for citing back to the person or for them to click. Opening the link uses the reader's own Jinear permissions, so it works for anyone who can already see the file, and for files shared with anyone who has the link. It does not return the file's contents, and it fails for folders and for files the signed in account cannot see.
list_filesread only- Lists the contents of a workspace's file storage, one folder at a time. Omit parentFolderId to list the root. Returns both folders and files; pass a folder's materialId back as parentFolderId to descend into it.
Stay connected offline_access
Keeps the connection alive until you disconnect it.